ControlGroup-Element

Stellt eine Gruppe von Steuerelementen in einer SizeDefinition-Layoutvorlage dar.

Verbrauch

<ControlGroup
  SequenceNumber = "xs:positiveInteger">
  child elements
</ControlGroup>

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Bemerkungen

Optional.

Kann für jedes Group- oder ControlGroup-Element ein oder mehrere Male auftreten.

Wenn keine Sequenznummern angegeben werden, werden Die 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, SplitButtonGallery oder ToggleButton

Andernfalls ist Group, wenn Row oder GroupSizeDefinition das übergeordnete Element ist, 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 Gruppenelementen 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ützte Mindestsystem: Windows 7
• Kann leer sein: Nein

Siehe auch

Anpassen eines Menübands durch Größendefinitionen und Skalierungsrichtlinien