TTMSFNCToolBarDropDownButton Class
Arrow drop-down button appended to a split toolbar button that opens a popup when clicked; can use a built-in styled arrow or a custom bitmap.
API unit family: TMSFNCToolBar
Inherits from: TTMSFNCDefaultToolBarButton
Syntax
TTMSFNCToolBarDropDownButton = class(TTMSFNCDefaultToolBarButton)
Properties
| Name | Description |
|---|---|
| Appearance | Appearance settings controlling the button background in each interaction state. Appearance settings controlling fill, stroke, and style for each interaction state. (inherited from TTMSFNCDefaultToolBarButton) |
| BitmapContainer | Bitmap container used to resolve named bitmaps for this button. (inherited from TTMSFNCDefaultToolBarButton) |
| BitmapVisible | When True, the button bitmap is rendered. (inherited from TTMSFNCDefaultToolBarButton) |
| Bitmaps | Scaled bitmaps shown on the button in its normal state. (inherited from TTMSFNCDefaultToolBarButton) |
| CanCopy | When True, this element can be copied to the compact popup toolbar. Set to False to exclude it from the compact view. (inherited from TTMSFNCCustomToolBarElement) |
| ControlIndex | Zero-based index of this control within the toolbar's control list. Set internally during layout; do not change at runtime. (inherited from TTMSFNCCustomToolBarElement) |
| DefaultStyle | When True, the drop-down button uses the built-in styled arrow icon. Set to False to supply a custom bitmap via Bitmaps. |
| DisabledBitmaps | Scaled bitmaps shown on the button in its disabled state. (inherited from TTMSFNCDefaultToolBarButton) |
| DisabledFontColor | Text color when the button is disabled. (inherited from TTMSFNCDefaultToolBarButton) |
| DownFontColor | Text color when the button is pressed. (inherited from TTMSFNCDefaultToolBarButton) |
| DownState | Programmatic down (pressed) state of the button. Set to True to keep the button visually pressed. (inherited from TTMSFNCDefaultToolBarButton) |
| Font | Font used to render the button label text. (inherited from TTMSFNCDefaultToolBarButton) |
| HorizontalTextAlign | Horizontal alignment of the label text within the button. (inherited from TTMSFNCDefaultToolBarButton) |
| HoverBitmaps | Scaled bitmaps shown on the button in its hovered state. (inherited from TTMSFNCDefaultToolBarButton) |
| HoverFontColor | Text color when the mouse hovers over the button. (inherited from TTMSFNCDefaultToolBarButton) |
| LastElement | When True, this is the last element in the toolbar; used for layout calculations. When True, this is the last element in the toolbar; used internally for layout boundary calculations. (inherited from TTMSFNCCustomToolBarElement) |
| PopupPlacement | Anchor side of the screen where the drop-down popup appears relative to the button. (inherited from TTMSFNCDefaultToolBarButton) |
| ShowFocus | When True, a focus rectangle is drawn when the button has keyboard focus. (inherited from TTMSFNCDefaultToolBarButton) |
| State | Current display state of the drop-down button (normal or large). Display state of this toolbar element — normal or large. (inherited from TTMSFNCCustomToolBarElement) |
| StretchText | When True, the label text stretches to fill the available text area. (inherited from TTMSFNCDefaultToolBarButton) |
| Text | Label text displayed on the drop-down button. (inherited from TTMSFNCDefaultToolBarButton) |
| TextVisible | When True, the button label text is rendered. (inherited from TTMSFNCDefaultToolBarButton) |
| Trimming | Controls how overlong label text is trimmed. (inherited from TTMSFNCDefaultToolBarButton) |
| UseStyledDropDownIcon | When True, the drop-down arrow is drawn using the built-in styled icon from the active theme. (inherited from TTMSFNCDefaultToolBarButton) |
| VerticalTextAlign | Vertical alignment of the label text within the button. (inherited from TTMSFNCDefaultToolBarButton) |
| WordWrapping | When True, the button label wraps to multiple lines. (inherited from TTMSFNCDefaultToolBarButton) |
Methods
| Name | Description |
|---|---|
| CloseDropDown | Closes the drop-down popup if it is open. (inherited from TTMSFNCDefaultToolBarButton) |
| Draw | Renders the button onto the given graphics canvas within the specified rectangle. (inherited from TTMSFNCDefaultToolBarButton) |
| DropDown | Opens the drop-down popup associated with this button. (inherited from TTMSFNCDefaultToolBarButton) |
| GetBitmap | Returns the first bitmap from the Bitmaps collection, or nil if none is set. (inherited from TTMSFNCDefaultToolBarButton) |
| GetPopupControl | Returns the internal popup control used for drop-down content. (inherited from TTMSFNCDefaultToolBarButton) |
| LoadSettingsFromFile | Loads the drop-down button settings from a file. |
| LoadSettingsFromStream | Loads the drop-down button settings from a stream. |