Элемент SizeDefinition

  • Статья

Представляет пользовательский шаблон макета элементов управления ленты.

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

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

Атрибуты

attribute Тип Обязательно Описание
имя;
 xs:positiveInteger или xs:string или xs:token
 Да
 Если Ribbon.SizeDefinitions является родительским, в противном случае — необязательно.

(xs:positiveInteger или xs:string или xs:token)
Строковое или целое значение от 2 до 59999 включительно или 0x2 и 0xea5f в шестнадцатеричном формате включительно.
Значение должно быть уникальным в XML-документе ленты.
Максимальная длина: 100 символов.

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

Элемент Описание
ControlNameMap
 Может произойти не более одного раза
GroupSizeDefinition
 Должен выполняться по крайней мере один раз

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

Элемент
Группа
Ribbon.SizeDefinitions

Комментарии

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

Может встречаться не более одного раза для каждого элемента Group .

Может возникать один или несколько раз для каждого элемента Ribbon.SizeDefinitions .

Предопределенные шаблоны макетов платформы ленты задаются с помощью атрибута SizeDefinition элемента Group .

Если соответствующий элемент ScalingPolicy.IdealSizes не объявлен для каждого элемента Group в элементе Tab , произойдет ошибка проверки.

Примеры

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

<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
  • Может быть пустым: Нет

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

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