Элемент MenuGroup

  • Статья

Представляет контейнер элементов управления для отображения в коллекции, меню или панели инструментов.

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

<MenuGroup
  Class = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</MenuGroup>

Атрибуты

attribute Тип Обязательно Описание
Класс
 xs:string
 Нет
 Задает размер и стиль макета для элементов в пользовательском интерфейсе меню.
Ресурс изображения можно предоставить в двух размерах (большой и маленький) и связать с элементом в разметке с помощью элементов свойств Command.LargeImages и Command.SmallImages . Если предоставлен только один образ, платформа при необходимости изменяет его размер.
Ограничивается одним из следующих значений:

(StandardItems)
По умолчанию.
Стиль: небольшое изображение и текст без выделения.
Снимок экрана: кнопка StandardItems.
(MajorItems)
Стиль: большое изображение и полужирный текст.

Примечание.
Если MenuGroup является дочерним элементом ApplicationMenu, атрибут Class игнорируется, а стиль MajorItems применяется платформой.


Снимок экрана: кнопка MajorItems.
CommandName
 xs:positiveInteger или xs:string
 Нет
 Связывает элемент с command.

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

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

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

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

Элемент
ApplicationMenu
ContextMenu
DropDownButton
DropDownGallery.MenuGroups
InRibbonGallery.MenuGroups
Мини-панель
SplitButton.MenuGroups
SplitButtonGallery.MenuGroups

Комментарии

Обязательный.

Должен выполняться по крайней мере один раз для каждого элемента ApplicationMenu, ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups, MiniToolbar или SplitButtonGallery.MenuGroups .

Если ApplicationMenu является родительским элементом, MenuGroup ограничивается следующими дочерними элементами: Button, DropDownButton, DropDownGallery, SplitButton или SplitButtonGallery.

Если contextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups или SplitButtonGallery.MenuGroups является родительским элементом, то MenuGroup ограничивается следующими дочерними элементами: Button, CheckBox, DropDownButton, DropDownColorPicker, DropDownGallery, SplitButton, SplitButton, SplitButtonGallery, или ToggleButton.

Если MiniToolbar является родительским элементом, MenuGroup ограничивается следующими дочерними элементами: Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, Spinner, SplitButton, SplitButtonGallery или ToggleButton.

Атрибут Class не требуется, если ApplicationMenu является родительским элементом. Платформа принудительно применяет значение MajorItems для атрибута Class.

Если ApplicationMenu является родительским элементом, атрибут Class не является обязательным.

Примеры

В следующем примере показана базовая разметка для SplitButton с элементом MenuGroup .

В этом разделе кода показаны объявления команд SplitButton и MenuGroup с большим и небольшим ресурсом изображения. Также объявляется связанная группа , выступающая в качестве родительского контейнера для элемента SplitButton .

<!-- SplitButton -->
<Command Name="cmdSplitButtonGroup"
         Symbol="cmdSplitButtonGroup"
         Comment="SplitButton Group"
         LabelTitle="SplitButton"/>
<Command Name="cmdSplitButton"
         Symbol="cmdSplitButton"
         Comment="SplitButton"
         LabelTitle="SplitButton"/>
<Command Name="cmdSBButtonItem"
         Symbol="cmdSBButtonItem"
         Comment="SBButtonItem"
         LabelTitle="SB ButtonItem"/>
<Command Name="cmdSBButton1"
         Symbol="cmdSBButton1"
         Comment="SBButton1"
         LabelTitle="SB Button">
  <Command.LargeImages>
    <Image Source="res/copyL_32.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/copyS_16.bmp"/>
  </Command.SmallImages>
  <Command.LargeHighContrastImages>
    <Image Source="res/copyLHC_32.bmp"/>
  </Command.LargeHighContrastImages>
  <Command.SmallHighContrastImages>
    <Image Source="res/copySHC_16.bmp"/>
  </Command.SmallHighContrastImages>
</Command>
<Command Name="cmdSBMajorItems"
         Comment="Major Items Category"
         LabelTitle="Major Items"/>
<Command Name="cmdSBStandardItems"
         Comment="Standard Items Category"
         LabelTitle="Standard Items"/>

В этом разделе кода показаны объявления элементов управления SplitButton и MenuGroup с и StandardItemsMajorItems.

<Group CommandName="cmdSplitButtonGroup">
  <SplitButton CommandName="cmdSplitButton">
    <SplitButton.ButtonItem>
      <Button CommandName="cmdSBButtonItem"/>
    </SplitButton.ButtonItem>
    <SplitButton.MenuGroups>
      <MenuGroup CommandName="cmdSBMajorItems" 
                 Class="MajorItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup CommandName="cmdSBStandardItems"
                 Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
    </SplitButton.MenuGroups>
  </SplitButton>
</Group>

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

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

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

Указание ресурсов образа ленты

Группа меню