ControlGroup-Element

Artikel
06/13/2023

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

Freigeben über