windowsforms-devexpress-dot-xtrabars-dot-navigation-dot-tilenavpanedropdownoptions-2e5eeba9.md
Gets or sets whether the opened drop-down tile bar closes on light dismiss.
Namespace : DevExpress.XtraBars.Navigation
Assembly : DevExpress.XtraBars.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DefaultValue(DefaultBoolean.Default)]
public DefaultBoolean CloseOnOuterClick { get; set; }
<DefaultValue(DefaultBoolean.Default)>
Public Property CloseOnOuterClick As DefaultBoolean
| 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 | Return Value |
|---|---|---|
| True |
The value is true.
|
0
| | False |
The value is false.
|
1
| | Default |
The value is specified by a global option or a higher-level object.
|
2
|
You can access this nested property as listed below:
| Object Type | Path to CloseOnOuterClick |
|---|---|
| TileNavElement |
.OptionsDropDown .CloseOnOuterClick
| | TileNavPane |
.OptionsPrimaryDropDown .CloseOnOuterClick
|
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.
See Also
TileNavPaneDropDownOptions Class