Élément ControlSizeDefinition

Article
06/13/2023

Représente le style de disposition d’un groupe de contrôles dans un modèle personnalisé.

Utilisation

<ControlSizeDefinition
  ImageSize = "xs:string"
  IsLabelVisible = "Boolean"
  IsImageVisible = "Boolean"
  IsPopup = "Boolean"
  ControlName = "xs:positiveInteger or xs:string"/>

Attributs

Attribut	Type	Obligatoire	Description
ControlName	xs:positiveInteger ou xs:string	Non	(xs:positiveInteger ou xs:string) Chaîne, valeur entière comprise entre 2 et 59999, inclusive, ou valeur hexadécimale comprise entre 0x2 et 0xea5f, inclusive. La valeur doit être unique dans le document XML du ruban. Longueur maximale : 100 caractères.
ImageSize	xs:string	Non	Limité à l’une des valeurs suivantes : (Grande) (Petit) Par défaut.
IsImageVisible	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) Par défaut. (false)
IsLabelVisible	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) Par défaut. (false)
IsPopup	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) (false)

Éléments enfants

Il n’y a pas d’éléments enfants.

Éléments parents

Élément
ControlGroup
GroupSizeDefinition
Ligne

Notes

Optionnel.

Peut se produire une ou plusieurs fois pour chaque élément ControlGroup, Row ou SizeDefinition .

Exemples

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

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

Voir aussi

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

Partager via