Elemento ControlGroup

Representa um grupo de controles em um modelo de layout SizeDefinition .

Uso

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

Atributos

Atributo	Type	Obrigatório	Descrição
SequenceNumber	xs:positiveInteger	No	Válido somente quando Group for o elemento pai. Cada SequenceNumber deve ser exclusivo dentro de um elemento Group . Os valores de SequenceNumber devem aumentar para cada elemento Group , mas não precisam ser sequenciais. (xs:positiveInteger) Qualquer valor inteiro positivo entre 1000 e 59999, inclusive.

Elementos filho

Elemento	Descrição
Botão	Pode ocorrer uma ou mais vezes
CheckBox	Pode ocorrer uma ou mais vezes
ComboBox	Pode ocorrer uma ou mais vezes
Controlsizedefinition	Pode ocorrer uma ou mais vezes
DropDownButton	Pode ocorrer uma ou mais vezes
DropDownColorPicker	Pode ocorrer uma ou mais vezes
DropDownGallery	Pode ocorrer uma ou mais vezes
FontControl	Pode ocorrer no máximo uma vez
InRibbonGallery	Pode ocorrer uma ou mais vezes
Controle giratório	Pode ocorrer uma ou mais vezes
SplitButton	Pode ocorrer uma ou mais vezes
SplitButtonGallery	Pode ocorrer uma ou mais vezes
ToggleButton	Pode ocorrer uma ou mais vezes

Elementos pai

Elemento
ControlGroup
Grupo
GroupSizeDefinition
Linha

Comentários

Opcional.

Pode ocorrer uma ou mais vezes para cada elemento Group ou ControlGroup .

Se nenhum número de sequência for fornecido, os elementos serão renderizados na ordem especificada na marcação faixa de opções.

Se Group ou ControlGroup for o elemento pai, ControlGroup será restrito aos seguintes elementos filho possíveis: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, InRibbonGallery, Spinner, SplitButton, SplitButtonGallery ou ToggleButton

Caso contrário, quando Row ou GroupSizeDefinition for o pai, Group será restrito ao seguinte elemento filho possível: ControlSizeDefinition.

Exemplos

O exemplo de código a seguir demonstra a marcação básica de um modelo personalizado de layout SizeDefinition de quatro botões com vários 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>

Informações do elemento

• Sistema mínimo com suporte: Windows 7
• Pode estar vazio: Não

Confira também

Personalizando uma faixa de opções por meio de definições de tamanho e políticas de dimensionamento