MenuGroup 元素

表示要显示在库、菜单或工具栏中的控件的容器。

使用情况

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

属性

属性	类型	必须	说明
类	xs:string	否	指定菜单 UI 中元素的大小和布局样式。 可以使用 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	可能发生一次或多次
CheckBox	可能发生一次或多次
ComboBox	可能发生一次或多次
DropDownButton	可能发生一次或多次
DropDownColorPicker	可能发生一次或多次
DropDownGallery	可能发生一次或多次
FontControl	最多可以发生一次
SplitButton	可能发生一次或多次
SplitButtonGallery	可能发生一次或多次
ToggleButton	可能发生一次或多次

父元素

元素
ApplicationMenu
ContextMenu
DropDownButton
DropDownGallery.MenuGroups
InRibbonGallery.MenuGroups
MiniToolbar
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、 SplitButtonGallery或 ToggleButton。

如果 MiniToolbar 是父元素，则 MenuGroup 将限制为以下子元素： Button、 CheckBox、 ComboBox、 DropDownButton、 DropDownColorPicker、 DropDownGallery、 FontControl、 Spinner、 SplitButton、 SplitButtonGallery 或 ToggleButton。

当 ApplicationMenu 是父元素时，不需要 Class 属性。 框架对 Class 属性强制使用 MajorItems 值。

当 ApplicationMenu 为父元素时，不需要 Class 属性。

示例

以下示例演示具有 MenuGroup 元素的 SplitButton 的基本标记。

此代码部分显示 SplitButton 和 MenuGroup 命令声明，其中包含一个大图像和一个小型图像资源。 还声明了一个关联的 Group，该 组 充当 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 控件声明以及 StandardItems 和 MajorItems。

<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
• 可以为空：否

请参阅

指定功能区图像资源

菜单组