TileNavPaneDropDownOptions.CloseOnOuterClick Property

Gets or sets whether the opened drop-down tile bar closes on light dismiss.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
public DefaultBoolean CloseOnOuterClick { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
Public Property CloseOnOuterClick As DefaultBoolean

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	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Property Paths

You can access this nested property as listed below:

Object Type	Path to CloseOnOuterClick
TileNavElement	.OptionsDropDown .CloseOnOuterClick
TileNavPane	.OptionsPrimaryDropDown .CloseOnOuterClick

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.