Элемент ControlGroup

Статья
06/13/2023

Представляет группу элементов управления в шаблоне макета 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 , 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
Может быть пустым: Нет

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

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

Поделиться через