Элемент ControlGroup

  • Статья

Представляет группу элементов управления в шаблоне макета SizeDefinition .

Использование

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

Атрибуты

attribute Тип Обязательно Описание
SequenceNumber
 xs:positiveInteger
 Нет
 Допустимо, только если Group является родительским элементом.
Каждый параметр SequenceNumber должен быть уникальным в пределах элемента Group . Значения SequenceNumber должны увеличиваться для каждого элемента Group , но не должны быть последовательными.

(xs:positiveInteger)
Любое положительное целочисленное значение от 1000 до 59999 включительно.

Дочерние элементы

Элемент Описание
Button
 Может произойти один или несколько раз
Флажок
 Может произойти один или несколько раз
ComboBox
 Может произойти один или несколько раз
ControlSizeDefinition
 Может произойти один или несколько раз
DropDownButton
 Может произойти один или несколько раз
DropDownColorPicker
 Может произойти один или несколько раз
DropDownGallery
 Может произойти один или несколько раз
FontControl
 Может возникать не более одного раза
InRibbonGallery
 Может произойти один или несколько раз
Spinner
 Может произойти один или несколько раз
SplitButton
 Может произойти один или несколько раз
SplitButtonGallery
 Может произойти один или несколько раз
ToggleButton
 Может произойти один или несколько раз

Родительские элементы

Элемент
ControlGroup
Группа
GroupSizeDefinition
Строка

Комментарии

Необязательный элемент.

Может выполняться один или несколько раз для каждого элемента Group или ControlGroup .

Если порядковые номера не указаны, элементы отрисовываются в порядке, указанном в разметке ленты.

Если родительским элементом является Group или ControlGroup , controlGroup ограничен следующими возможными дочерними элементами: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, InRibbonGallery, Spinner, SplitButton, SplitButtonGallery или ToggleButton

В противном случае, если Row или GroupSizeDefinition является родительским элементом, Group ограничивается следующим возможным дочерним элементом: ControlSizeDefinition.

Примеры

В следующем примере кода демонстрируется базовая разметка для пользовательского шаблона макета SizeDefinition с четырьмя кнопками с различными элементами 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>

Сведения об элементе

  • Минимальная поддерживаемая система: Windows 7
  • Может быть пустым: Нет

См. также раздел

Настройка ленты с помощью определений размера и политик масштабирования