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.

(xs:positiveInteger)
Ein positiver ganzzahliger Wert zwischen 1000 und 59999 einschließlich .

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

Siehe auch

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