Élément ControlGroup

Article
06/13/2023

Représente un groupe de contrôles dans un modèle de disposition SizeDefinition .

Utilisation

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

Attributs

Attribut	Type	Obligatoire	Description
SequenceNumber	xs:positiveInteger	Non	Valide uniquement lorsque Group est l’élément parent. Chaque SequenceNumber doit être unique au sein d’un élément Group . Les valeurs de SequenceNumber doivent augmenter pour chaque élément Group , mais elles n’ont pas besoin d’être séquentielles. (xs:positiveInteger) Toute valeur entière positive comprise entre 1000 et 59999, inclus.

Éléments enfants

Élément	Description
Button	Peut se produire une ou plusieurs fois
Case	Peut se produire une ou plusieurs fois
ComboBox	Peut se produire une ou plusieurs fois
ControlSizeDefinition	Peut se produire une ou plusieurs fois
DropDownButton	Peut se produire une ou plusieurs fois
DropDownColorPicker	Peut se produire une ou plusieurs fois
DropDownGallery	Peut se produire une ou plusieurs fois
FontControl	Peut se produire au plus une fois
InRibbonGallery	Peut se produire une ou plusieurs fois
Spinner	Peut se produire une ou plusieurs fois
SplitButton	Peut se produire une ou plusieurs fois
SplitButtonGallery	Peut se produire une ou plusieurs fois
ToggleButton	Peut se produire une ou plusieurs fois

Éléments parents

Élément
ControlGroup
Groupe
GroupSizeDefinition
Ligne

Notes

Optionnel.

Peut se produire une ou plusieurs fois pour chaque élément Group ou ControlGroup .

Si aucun numéro de séquence n’est fourni, les éléments sont rendus dans l’ordre spécifié dans le balisage du ruban.

Si Group ou ControlGroup est l’élément parent, ControlGroup est limité aux éléments enfants suivants : Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, InRibbonGallery, Spinner, SplitButton, SplitButtonGallery ou ToggleButton

Sinon, lorsque Row ou GroupSizeDefinition est le parent, Group est limité à l’élément enfant possible suivant : ControlSizeDefinition.

Exemples

L’exemple de code suivant illustre le balisage de base d’un modèle de disposition SizeDefinition à quatre boutons personnalisé avec différents éléments Group .

<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>

Informations sur les éléments

Système minimum pris en charge : Windows 7
Peut être vide : Non

Voir aussi

Personnalisation d’un ruban via des définitions de taille et des stratégies de mise à l’échelle