DeselectOnDown Property

Summary

Gets or sets a value that indicates whether to de-select any objects as soon as the user clicks down with the cursor or taps using touch on the container outside of its boundaries.

Syntax

Java

Objective-C

WinRT C#

C++

public bool DeselectOnDown { get; set; }

Public Property DeselectOnDown As Boolean

public bool DeselectOnDown {get; set;}

@property (nonatomic) BOOL deselectOnDown;

public boolean getDeselectOnDown() 
public void setDeselectOnDown(boolean value)

 <br/>get_DeselectOnDown();<br/>set_DeselectOnDown(value);<br/>Object.defineProperty('DeselectOnDown');

public:  
   property bool DeselectOnDown 
   { 
      bool get() 
      void set(bool value) 
   }

Property Value

true to de-select any object as soon as the user clicks down on the container outside its boundaries; otherwise, false and the objects become de-selected only when the user releases the cursor or touch. The default value is true.

Remarks

In some situations, the objects should remain selected when the user first clicks or taps using touch outside their boundaries since another action might follow. For example, the LEADTOOLS Document Viewer changes the value of DeselectOnDown to false since it uses multiple interactive modes all working at the same time and the user can click outside the objects then perform a drag operation to pan or zoom the view in or out. This extra operation will be performed while the objects remain selected. The objects become de-selected only if the user clicks and then releases without any further action.

Requirements

Target Platforms