TcxCustomButton Class
Represents an enhanced variant of the TButton component.
Declaration
TcxCustomButton = class(
TCustomButton,
IdxSkinSupport,
IcxLookAndFeelContainer,
IdxFadingObject,
IdxScaleFactor,
IdxAdornerTargetElement,
IdxAdornerRootTargetElement,
IdxAutomationElement
)
Remarks
TcxCustomButton
can work in three different modes, which can be activated via the Kind property. In standard mode, the TcxCustomButton
functions as a regular button. If the Kind property is set to the cxbkDropDown
, cxbkDropDownButton
, or cxbkOfficeDropDown
and the DropDownMenu property is assigned a popup menu component, clicking a button (or the dropdown button located at the right side of this button) results in opening the specified popup menu. When in cxbkDropDown
mode, TcxCustomButton
does not generate the OnClick event when a user presses it. Instead, handle the OnPopup event of the specified dropdown menu or the button’s OnDropDownMenuPopupEx or OnDropDownMenuPopup event, to respond to invoking the dropdown menu.
With TcxCustomButton, you can mimic the appearance and behavior of standard VCL TSpeedButton controls. To accomplish this, use the SpeedButtonOptions properties.
The look & feel of the button can be specified via the LookAndFeel property. The LookAndFeel.NativeStyle property determines whether the button is painted using the native style. The LookAndFeel.Kind property specifies the borders, colors and highlighting settings applied to a button. You can also apply skins via the LookAndFeel.SkinName property or completely custom paint the button by handling the OnCustomDraw event.
Button image options are specified via the button’s OptionsImage property.