Page History
...
| Element | Description | Version Introduced | Pro Version Introduced |
|---|---|---|---|
| <Backstage> | The list of buttons and pages in the popup that appears when the user clicks the system button. | 1.0 | 3.2 |
| <Group> | A single group that appears within a single tab and contains controls. | 1.0 | 3.2 |
| <QuickAccessControls> | A list of controls that appear in the quick access toolbar. | 1.0 | 3.2 |
| A button control with a drop down that can contain other controls. | 1.0 | 3.2 | |
| <TabBarControls> | The list of controls that appear on the right end of the tab bar area. | 1.0 | 3.2 |
...
| Element | Description | Appears | Version Introduced | Pro Version Introduced |
|---|---|---|---|---|
| <Button> | A button control associated with a command. | Zero or once | 1.0 | 3.2 |
| <CheckBox> | A check box control. | Zero or once | 1.0 | 3.2 |
| <ComboBox> | A combo box control. | Zero or once | 1.0 | 3.2 |
| <Command> | A single command that is associated to one or more buttons on the ribbon. | Zero or once | 1.0 | 3.2 |
| <DateField> | A date field control with a calendar drop down. | Zero or once | 1.0 | 3.2 |
| <EditField> | An edit field control. | 1.0 | 3.2 | |
| <Label> | A label control that only display some text. | 1.0 | 3.2 | |
| <SplitButton> | A button control with a drop down that can contain other controls. | Zero or once | 1.0 | 3.2 |
...
The Command attribute lets you associate an existing command with this split button. Associating a split button to a command is the only way to set it's icon, caption, etc. If you omit this attribute, then you need to include a child <Command> element within the button element.
...
The SplitButton element defines a split button control. A split button is a button with a drop down arrow. The user can either click on the button portion, which will execute the associated command or the drop down to get a popup with more controls. In order to set the button's caption, icon, and other attributes, you must associate it with a command. You can do this using either the Command attribute as explained above or by including a child <Command> element.
You can add any number of other controls to a split button. Those controls will appear in the popup the is triggered by the drop down portion of the control. Note that you can even have child split buttons, making this feature infinitely recursive.
Example
| Code Block |
|---|
<SplitButton Key="SPL_PASTE"> <Command Key="PASTE" Caption="Paste" Shortcut="Alt+F1" LargeIcon="Images\32x32\clipboard_paste.png" SmallIcon="Images\16x16\clipboard_paste.png" Tooltip="Inserts text from the clipboard." /> <Button Key="BTN_PASTEWITHFORMAT"> <Command Key="PASTEWITHFORMAT" Caption="Keep Source Formatting" LargeIcon="Images\32x32\clipboard_paste.png" SmallIcon="Images\16x16\clipboard_paste.png" Tooltip="Inserts formatted text from the clipboard." /> </Button> <Button Key="BTN_PASTEMERGE"> <Command Key="PASTEMERGE" Caption="Merge Formatting" Enabled="False" LargeIcon="Images\32x32\clipboard-add2.png" SmallIcon="Images\16x16\clipboard-add2.png" Tooltip="Inserts text from the clipboard using the current selection's formatting." /> </Button> <Button Key="BTN_PASTETEXTONLY"> <Command Key="PASTETEXTONLY" Caption="Keep Text Only" LargeIcon="Images\32x32\clipboard.png" SmallIcon="Images\16x16\clipboard.png" Tooltip="Inserts text only from the clipboard." /> </Button> </SplitButton> |
