ControlGroup-Element

  • Artikel

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
 Nein
 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 aber nicht sequenziell sein.

(xs:positiveInteger)
Jeder positive ganzzahlige 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 höchstens 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

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