Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A button control associated with a command.

Parent Elements

This element can appear as a child of the following elements.

ElementDescriptionVersion IntroducedPro Version Introduced
<Backstage>The list of buttons and pages in the popup that appears when the user clicks the system button.1.03.2
<Group>A single group that appears within a single tab and contains controls.1.03.2
<QuickAccessControls>A list of controls that appear in the quick access toolbar.1.03.2
<SplitButton>A button control with a drop down that can contain other controls.1.03.2
<TabBarControls>The list of controls that appear on the right end of the tab bar area.1.03.2

Child Elements

The following elements can be children of this one.

ElementDescriptionAppearsVersion IntroducedPro Version Introduced
<Command>A single command that is associated to one or more buttons on the ribbon.Zero or once1.03.2

Attributes

This element supports the following attributes:

...

The Key attribute defines a unique identifier for the button. The identifier must be unique among controls but can share the same identifier as other elements such as commands or tabs.

Remarks

The Button element defines a button control. 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.

Example

 

Code Block
<Button Command="SAVE" />
<Button>
  <Command Key="SAVE_AS" Caption="Save As" KeyboardTip="A"
           LargeIcon="Images\32x32\save.png"
           SmallIcon="Images\16x16\save.png"
           Tooltip="Saves the document to the selected file." />
</Button>