Élément SizeDefinition

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

Usage

<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 en hexadécimal, inclus.
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
Ruban. SizeDefinitions

Notes

Optionnel.

Peut se produire au plus une fois pour chaque élément de groupe .

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

Les modèles de disposition de l’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 de Groupe 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 minimal pris en charge: Windows 7
  • Peut être vide: non

Voir aussi

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