TileBar.DropDownShowing Event

Fires when a tile’s dropdown button is clicked.

Namespace : DevExpress.XtraBars.Navigation

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

public event TileBarDropDownShowingEventHandler DropDownShowing

Public Event DropDownShowing As TileBarDropDownShowingEventHandler

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.