Элемент MenuGroup

Статья
09/03/2023

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

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

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

Атрибуты

attribute	Тип	Обязательно	Описание
Класс	xs:string	Нет	Задает размер и стиль макета для элементов в пользовательском интерфейсе меню. Ресурс изображения можно предоставить в двух размерах (большой и маленький) и связать с элементом в разметке с помощью элементов свойств Command.LargeImages и Command.SmallImages . Если предоставлен только один образ, платформа при необходимости изменяет его размер. Ограничивается одним из следующих значений: (StandardItems) По умолчанию. Стиль: небольшое изображение и текст без выделения. (MajorItems) Стиль: большое изображение и полужирный текст. Примечание. Если MenuGroup является дочерним элементом ApplicationMenu, атрибут Class игнорируется, а стиль `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
Может быть пустым: Нет

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

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

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