Elemento ControlGroup

  • Artículo

Representa un grupo de controles en una plantilla de diseño SizeDefinition .

Uso

<ControlGroup
  SequenceNumber = "xs:positiveInteger">
  child elements
</ControlGroup>

Atributos

Atributo Tipo Obligatorio Descripción
SequenceNumber
 xs:positiveInteger
 No
 Válido solo cuando Group es el elemento primario.
Cada sequenceNumber debe ser único dentro de un elemento Group . Los valores de SequenceNumber deben aumentar para cada elemento Group , pero no es necesario secuencial.

(xs:positiveInteger)
Cualquier valor entero positivo entre 1000 y 59999, ambos incluidos.

Elementos secundarios

Elemento Descripción
Button
 Puede producirse una o varias veces
CheckBox
 Puede producirse una o varias veces
ComboBox
 Puede producirse una o varias veces
ControlSizeDefinition
 Puede producirse una o varias veces
DropDownButton
 Puede producirse una o varias veces
DropDownColorPicker
 Puede producirse una o varias veces
DropDownGallery
 Puede producirse una o varias veces
FontControl
 Puede producirse como máximo una vez
InRibbonGallery
 Puede producirse una o varias veces
Spinner
 Puede producirse una o varias veces
SplitButton
 Puede producirse una o varias veces
SplitButtonGallery
 Puede producirse una o varias veces
ToggleButton
 Puede producirse una o varias veces

Elementos primarios

Elemento
ControlGroup
Group (Grupo)
GroupSizeDefinition
Row

Comentarios

Opcional.

Puede producirse una o varias veces para cada elemento Group o ControlGroup .

Si no se proporcionan números de secuencia, los elementos se representan en el orden especificado en el marcado de la cinta de opciones.

Si Group o ControlGroup es el elemento primario, ControlGroup está restringido a los siguientes elementos secundarios posibles: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, InRibbonGallery, Spinner, SplitButton, SplitButtonGallery o ToggleButton

De lo contrario, cuando Row o GroupSizeDefinition es el elemento primario, Group está restringido al siguiente elemento secundario posible: ControlSizeDefinition.

Ejemplos

En el ejemplo de código siguiente se muestra el marcado básico de una plantilla de diseño SizeDefinition personalizada con cuatro botones con varios elementos 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>

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