PushButtonStyle Enumeration

Description

BackstageButton styles.

Members

xtpButtonNormal
Normal BackstageButton.
xtpButtonDropDown
Dropdown button. Button will have an arrow indicating it has a dropdown. The dropdown will appear under the button.
xtpButtonDropDownRight
Dropdown button. Button will have an arrow indicating it has a dropdown. The dropdown will appear to the right of the button.
xtpButtonSplitDropDown
Split button. Button will be split into a "button" part and "arrow" part. The "arrow" part will have an arrow indicating it has a dropdown. The dropdown will appear under the button when the "arrow" part is clicked.
xtpButtonDropDownNoGlyph
This is a Dropdown button with the appearance of a normal button. The DropDown event will fire when this button is clicked. This is used for Backstage buttons that look like a normal button but display a dropdown.

This is also used when you want a dropdown button but want to display your own "arrow" in markup. There is a built-in resource for the 2010 style dropdown that can easily be displayed using Source='res://XTP_IDB_BUTTONDROPDOWNGLYPH'. For example, you could use this for the Caption of the BackstageButton:

"Protect Document"

Remarks

The PushButton.Style uses flags from the PushButtonStyle enumeration to set the style of the button.

Using xtpButtonNormal will create a normal button.

The DropDown event is used so you can display a popup menu for the button.

If the Style is set to xtpButtonDropDown or xtpButtonDropDownRight, the DropDown event is fired when the button is clicked anywhere on the button.

If the Style is set to xtpButtonSplitDropDown, the DropDown event is only fired when the "arrow" part of the split button is clicked. The Click event will be fired when the "button" part of the split button is clicked.