ControlGroup-Element
Stellt eine Gruppe von Steuerelementen in einer SizeDefinition-Layoutvorlage dar.
Verbrauch
<ControlGroup
SequenceNumber = "xs:positiveInteger">
child elements
</ControlGroup>
Attribute
| attribute | type | Erforderlich | Beschreibung |
|---|---|---|---|
| SequenceNumber |
xs:positiveInteger |
No |
Nur gültig, wenn Group das übergeordnete Element ist. Jede SequenceNumber muss innerhalb eines Group-Elements eindeutig sein. Die Werte für SequenceNumber sollten für jedes Group-Element erhöht werden, müssen jedoch nicht sequenziell sein. |
Untergeordnete Elemente
| Element | Beschreibung |
|---|---|
| Schaltfläche |
Kann ein oder mehrere Male auftreten. |
| Checkbox |
Kann ein oder mehrere Male auftreten. |
| ComboBox |
Kann ein oder mehrere Male auftreten. |
| ControlSizeDefinition |
Kann ein oder mehrere Male auftreten. |
| DropDownButton |
Kann ein oder mehrere Male auftreten. |
| DropDownColorPicker |
Kann ein oder mehrere Male auftreten. |
| DropDownGallery |
Kann ein oder mehrere Male auftreten. |
| FontControl |
Kann nur einmal auftreten. |
| InRibbonGallery |
Kann ein oder mehrere Male auftreten. |
| Spinner |
Kann ein oder mehrere Male auftreten. |
| SplitButton |
Kann ein oder mehrere Male auftreten. |
| SplitButtonGallery |
Kann ein oder mehrere Male auftreten. |
| ToggleButton |
Kann ein oder mehrere Male auftreten. |
Übergeordnete Elemente
| Element |
|---|
| ControlGroup |
| Gruppe |
| GroupSizeDefinition |
| Zeile |
Hinweise
Optional.
Kann ein oder mehrere Male für jedes Group- oder ControlGroup-Element auftreten.
Wenn keine Sequenznummern angegeben werden, werden Elemente in der im Menübandmarkup angegebenen Reihenfolge gerendert.
Wenn Group oder ControlGroup das übergeordnete Element ist, ist ControlGroup auf die folgenden möglichen untergeordneten Elemente beschränkt: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, InRibbonGallery, Spinner, SplitButton, SplitButtonGalleryoder ToggleButton
Wenn Row oder GroupSizeDefinition das übergeordnete Element ist, ist Group andernfalls auf das folgende mögliche untergeordnete Element beschränkt: ControlSizeDefinition.
Beispiele
Im folgenden Codebeispiel wird das grundlegende Markup für eine benutzerdefinierte SizeDefinition-Layoutvorlage mit vier Schaltflächen mit verschiedenen Group-Elementen veranschaulicht.
<Group CommandName="cmdButtonGroup2">
<SizeDefinition>
<ControlNameMap>
<ControlNameDefinition Name="button1"/>
<ControlNameDefinition Name="button2"/>
<ControlNameDefinition Name="button3"/>
<ControlNameDefinition Name="button4"/>
</ControlNameMap>
<GroupSizeDefinition Size="Large">
<ControlGroup>
<ControlSizeDefinition ControlName="button1"
ImageSize="Large"
IsLabelVisible="true" />
<ControlSizeDefinition ControlName="button2"
ImageSize="Large"
IsLabelVisible="true" />
</ControlGroup>
<ColumnBreak ShowSeparator="true"/>
<ControlGroup>
<ControlSizeDefinition ControlName="button3"
ImageSize="Large"
IsLabelVisible="true" />
<ControlSizeDefinition ControlName="button4"
ImageSize="Large"
IsLabelVisible="true" />
</ControlGroup>
</GroupSizeDefinition>
<GroupSizeDefinition Size="Medium">
<Row>
<ControlSizeDefinition ControlName="button1"
ImageSize="Small"
IsLabelVisible="true" />
<ControlSizeDefinition ControlName="button3"
ImageSize="Small"
IsLabelVisible="true" />
</Row>
<Row>
<ControlSizeDefinition ControlName="button2"
ImageSize="Small"
IsLabelVisible="true" />
<ControlSizeDefinition ControlName="button4"
ImageSize="Small"
IsLabelVisible="true" />
</Row>
</GroupSizeDefinition>
<GroupSizeDefinition Size="Small">
<Row>
<ControlSizeDefinition ControlName="button1"
ImageSize="Small"
IsLabelVisible="true" />
<ControlSizeDefinition ControlName="button3"
ImageSize="Small"
IsLabelVisible="false" />
</Row>
<Row>
<ControlSizeDefinition ControlName="button2"
ImageSize="Small"
IsLabelVisible="true" />
<ControlSizeDefinition ControlName="button4"
ImageSize="Small"
IsLabelVisible="false" />
</Row>
</GroupSizeDefinition>
</SizeDefinition>
<Button CommandName="cmdButtonG21"></Button>
<Button CommandName="cmdButtonG22"></Button>
<Button CommandName="cmdButtonG23"></Button>
<Button CommandName="cmdButtonG24"></Button>
</Group>
<Group CommandName="cmdCheckBoxGroup">
<CheckBox CommandName="cmdCheckBox"></CheckBox>
</Group>
<Group CommandName="cmdToggleButtonGroup"
SizeDefinition="OneButton">
<ToggleButton CommandName="cmdToggleButton"></ToggleButton>
</Group>
<Group CommandName="cmdButtonGroup"
SizeDefinition="ThreeButtons">
<Button CommandName="cmdButton1"></Button>
<Button CommandName="cmdButton2"></Button>
<Button CommandName="cmdButton3"></Button>
</Group>
Elementinformationen
- Unterstütztes Mindestsystem: Windows 7
- Kann leer sein: Nein