MenuGroup 元素

表示要顯示在資源庫、功能表或工具列中的控制項容器。

使用方式

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

屬性

屬性 類型 必要 描述
類別
xs:string

指定功能表 UI 中元素的大小和版面配置樣式。
影像資源可以使用 Command.LargeImagesCommand.SmallImages 屬性元素,以兩個大小提供 (大和小型) ,並與標記中的專案相關聯。 如果只提供一個映射,架構會視需要調整大小。
限制為下列其中一個值:

(StandardItems)
預設值。
樣式:小型影像和反強調的文字。
Screen shot of a StandardItems button.
(MajorItems)
樣式:大型影像和粗體文字。
[!注意]
如果 MenuGroupApplicationMenu的子系,則會忽略 Class 屬性,而且 架構會強制執行 的樣式 MajorItems

Screen shot of a MajorItems button.
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

備註

必要。

每個 ApplicationMenuCoNtextMenuDropDownButtonDropDownGallery.MenuGroupsInRibbonGallery.MenuGroupsSplitButton.MenuGroupsMiniToolbarSplitButtonGallery.MenuGroups 元素必須至少發生一次。

如果ApplicationMenu是父元素,則 MenuGroup會限制為下列子項目:ButtonDropDownButtonDropDownGallerySplitButton 或 SplitButtonGallery

如果CoNtextMenuDropDownButtonDropDownGallery.MenuGroupsInRibbonGallery.MenuGroupsSplitButton.MenuGroupsSplitButtonGallery.MenuGroups是父元素,則 MenuGroup會限制為下列子項目:ButtonCheckBoxDropDownButtonDropDownColorPickerDropDownGallerySplitButton、SplitButtonGallery、 或ToggleButton

如果 MiniToolbar 是父元素, 則 MenuGroup 會限制為下列子項目: ButtonCheckBoxComboBoxDropDownButtonDropDownColorPickerDropDownGalleryFontControlSpinnerSplitButtonSplitButtonGalleryToggleButton

當 ApplicationMenu是父元素時,不需要 Class 屬性。 架構會針對 Class 屬性強制執行 MajorItems 的值。

ApplicationMenu 是父元素時,不需要 Class 屬性。

範例

下列範例示範具有MenuGroup元素之SplitButton的基本標記。

這一節的程式碼會顯示具有大型和小型影像資源的 SplitButtonMenuGroup 命令宣告。 也會宣告做為SplitButton元素父容器的相關聯Group

<!-- 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"/>

此程式碼區段會顯示具有 StandardItemsMajorItemsSplitButtonMenuGroup控制項宣告。

<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
  • 可以是空的:否

另請參閱

指定功能區映射資源

功能表群組