MenuGroup 元素
表示要顯示在資源庫、功能表或工具列中的控制項容器。
使用方式
<MenuGroup
Class = "xs:string"
CommandName = "xs:positiveInteger or xs:string">
child elements
</MenuGroup>
屬性
| 屬性 | 類型 | 必要 | Description |
|---|---|---|---|
|
類別 |
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 命令宣告。 也會宣告做為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"/>
此程式碼區段會顯示和 的 StandardItemsMajorItemsSplitButton和MenuGroup控制項宣告。
<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
- 可以是空的：否