TileBar.DropDownShowing Event
Fires when a tile’s dropdown button is clicked.
Namespace: DevExpress.XtraBars.Navigation
Assembly: DevExpress.XtraBars.v23.2.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
Event Data
The DropDownShowing event's data class is TileBarDropDownShowingEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Cancel | Gets or sets a value indicating whether the event should be canceled. Inherited from CancelEventArgs. |
| DropDownContainer | Gets or sets the dropdown control associated with the current tile. |
| Item | Gets or sets the tile whose dropdown button has been clicked. |
Remarks
A tile can be associated with a dropdown control via the TileBarItem.DropDownControl property. Once a control is assigned to the tile, the tile displays a dropdown button, whose visibility can be modified with the TileBarItem.ShowDropDownButton property. You can set the TileBarItem.ShowDropDownButton property to true to forcibly display the dropdown button, even if no dropdown control is assigned to the tile.
The DropDownShowing event fires when an end-user clicks the tile’s dropdown button. You can handle this event for the following purposes:
- To prevent a dropdown control from being displayed in specific cases, set the event’s Cancel property to true.
- To dynamically assign dropdown controls to tiles, assign dropdown controls to the event’s TileBarDropDownShowingEventArgs.DropDownContainer property.
- To customize the contents of a tile’s dropdown control, use the TileBarDropDownShowingEventArgs.DropDownContainer property to access and customize the dropdown control.