Elemento SizeDefinition

Representa una plantilla de diseño personalizada de controles de cinta de opciones.

Uso

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

Atributos

Atributo Tipo Requerido Descripción
Nombre
xs:positiveInteger o xs:string o xs:token

Cuando Ribbon.SizeDefinitions es el elemento primario, de lo contrario, opcional.

(xs:positiveInteger o xs:string o xs:token)
Una cadena o un valor entero entre 2 y 59999, inclusive o 0x2 y 0xea5f en hexadecimal, ambos incluidos.
El valor debe ser único en el documento XML de la cinta de opciones.
Longitud máxima: 100 caracteres.

Elementos secundarios

Elemento Descripción
ControlNameMap
Puede producirse como máximo una vez

GroupSizeDefinition
Debe producirse al menos una vez

Elementos primarios

Elemento
Group (Grupo)
Ribbon.SizeDefinitions

Observaciones

Opcional.

Puede producirse como máximo una vez para cada elemento Group .

Puede producirse una o varias veces para cada elemento Ribbon.SizeDefinitions .

Las plantillas de diseño del marco de la cinta predefinidas se especifican con el atributo SizeDefinition del elemento Group .

Si un elemento ScalingPolicy.IdealSizes correspondiente no se declara para cada elemento Group de un elemento Tab , se producirá un error de validación.

Ejemplos

En el ejemplo de código siguiente se muestra una plantilla personalizada básica.

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

Información de elemento

  • Sistema mínimo admitido: Windows 7
  • Puede estar vacío: No

Consulte también

Personalización de una cinta de opciones mediante definiciones de tamaño y directivas de escalado