Élément SizeDefinition

Article
06/13/2023

Représente un modèle de disposition personnalisé des contrôles du ruban.

Utilisation

<SizeDefinition
  Name = "xs:positiveInteger or xs:string or xs:token">
  child elements
</SizeDefinition>

Attributs

Attribut	Type	Obligatoire	Description
Nom	xs:positiveInteger ou xs:string ou xs:token	Oui	Lorsque Ribbon.SizeDefinitions est le parent, sinon facultatif. (xs:positiveInteger ou xs:string ou xs:token) Chaîne ou valeur entière comprise entre 2 et 59999, inclusive ou 0x2 et 0xea5f hexadécimale, inclusive. La valeur doit être unique dans le document XML du ruban. Longueur maximale : 100 caractères.

Éléments enfants

Élément	Description
ControlNameMap	Peut se produire au plus une fois
GroupSizeDefinition	Doit se produire au moins une fois

Éléments parents

Élément
Groupe
Ribbon.SizeDefinitions

Notes

Optionnel.

Peut se produire au maximum une fois pour chaque élément Group .

Peut se produire une ou plusieurs fois pour chaque élément Ribbon.SizeDefinitions .

Les modèles de disposition d’infrastructure du ruban prédéfinis sont spécifiés avec l’attribut SizeDefinition de l’élément Group .

Si un élément ScalingPolicy.IdealSizes correspondant n’est pas déclaré pour chaque élément Group dans un élément Tab , une erreur de validation se produit.

Exemples

L’exemple de code suivant illustre un modèle personnalisé de base.

<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

Partager via