TcxCustomButton.OnDropDownMenuPopupEx Event

Occurs when the button’s dropdown menu is about to be displayed on screen.

Declaration

property OnDropDownMenuPopupEx: TcxButtonDropDownMenuPopupExEvent read; write;

Remarks

This event is fired only for buttons whose Kind property is set to cxbkDropDown, cxbkDropDownButton, or cxbkOfficeDropDown. Handling the event is useful, for instance, if you want to handle the dropdown menu appearance in a custom way or dynamically assign the popup menu to be displayed at runtime.

The APopupMenu parameter specifies the popup menu component to be displayed. This parameter is initialized with the popup menu component specified via the button’s DropDownMenu property. You can replace the parameter value with any other supported popup menu component. Refer to the DropDownMenu property description to learn about supported popup menu components.

Set the AHandled parameter to True (the default value is False) to prohibit the dropdown menu from being displayed.

The OnDropDownMenuPopupEx event is fired before the OnDropDownMenuPopup event, which fires only if False is passed as the AHandled parameter of the OnDropDownMenuPopupEx event handler. Normally, you don’t need to handle both these events.