A label control that only display some text.
Parent Elements
This element can appear as a child of the following elements.
Element | Description | Version Introduced | Pro Version Introduced |
---|---|---|---|
<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 |
<SplitButton> | 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 |
Attributes
This element supports the following attributes:
Attribute | Description | Version Introduced | Pro Version Introduced |
---|---|---|---|
BeginGroup | Determines if this control begins a new group. | 1.0 | 3.2 |
Caption | The control's text. | 1.0 | 3.2 |
Key | The unique identifier of this control. Must be unique among all other controls. (Required) | 1.0 | 3.2 |
Height | The height of the control | 1.0 | 3.2 |
Width | The width of the control | 1.0 | 3.2 |
BeginGroup
The BeginGroup attribute can be set to "True" or "False". When set to "True", it informs the ribbon that this control should not be grouped with the control before it and should be the first control in a new group. This attribute only works if the control is in a group whose GroupControls attribute is "True". NOTE: This attribute must usually be set to true if you want the ensure the label is to the left of a certain control. See the Label Controls article for details.
Caption
The Caption attribute defines the text to be displayed.
Key
The Key attribute defines the unique identifier you will use in properties, methods, or events to identify this control. This needs to be unique among all other controls, regardless of control type.
Height
The Height attribute sets a new fixed height for the control.
Width
The Width attribute sets a new fixed width for the control.
Remarks
The Label element defines a label control that will appear on the ribbon. The label's only job is to display text, and it can be useful for labeling other controls that do not support captions.
Example
<Label Key="STA_FONT" Caption="Current Font" Height="22" BeginGroup="true" />