MenuGroup 元素
表示要显示在库、菜单或工具栏中的控件的容器。
使用情况
<MenuGroup
Class = "xs:string"
CommandName = "xs:positiveInteger or xs:string">
child elements
</MenuGroup>
属性
| 属性 | 类型 | 必须 | 说明 |
|---|---|---|---|
|
类 |
xs:string |
否 |
指定菜单 UI 中元素的大小和布局样式。 可以使用 Command.LargeImages 和 Command.SmallImages 属性元素以大小) (两种大小提供图像资源，并与标记中的元素相关联。 如果只提供一个图像，框架会根据需要调整其大小。 限制为以下值之一： 样式：小图像和去强调的文本。 
注意：
|
| CommandName |
xs：positiveInteger 或 xs：string |
否 |
将 元素与 Command 相关联。 该值在功能区 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
- 可以为空：否