TileNavPaneDropDownOptions.CloseOnOuterClick Property
Gets or sets whether the opened drop-down tile bar closes on light dismiss.
Namespace: DevExpress.XtraBars.Navigation
Assembly: DevExpress.XtraBars.v19.2.dll
Declaration
Property Value
| Type | Default | Description |
|---|---|---|
| DefaultBoolean | **Default** | A DefaultBoolean enumeration value specifying whether the opened drop-down tile bar closes on light dismiss. |
Available values:
| Name | Description |
|---|---|
| True | Corresponds to a Boolean value of true. |
| False | Corresponds to a Boolean value of false. |
| Default | The value is determined by the current object’s parent object setting (e.g., a control setting). |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to CloseOnOuterClick |
|---|---|
| TileNavCategory |
|
| TileNavElement |
|
| TileNavItem |
|
| TileNavPane |
|
| TileNavSubItem |
|
Remarks
By default, the opened drop-down tile bar is dismissed if an end-user clicks a navigation element in this drop-down or in the nav bar. It is also dismissed if a user resumes interaction with the application anywhere outside the TileNavPane (performs a click anywhere outside the TileNavPane). This behavior is called light dismiss. To prevent the drop-down tile bar from being closed, set the CloseOnOuterClick property to False. In this case, the drop-down tile bar closes only if an end-user clicks a navigation element in the TileNavPane.
The Default value assigned to the TileNavPane.OptionsPrimaryDropDown.CloseOnOuterClick property is equivalent to True.
The Default value assigned to the TileNavElement.OptionsDropDown.CloseOnOuterClick property means that the close behavior of the drop-down tile bar associated with this TileNavElement is controlled by the TileNavPane.OptionsPrimaryDropDown.CloseOnOuterClick property.
The CloseOnOuterClick property is not in effect for the secondary drop-down tile bar.