Partager via


Élément ControlGroup

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