MenuGroup 元素

  • 發行項

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

使用方式

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

屬性

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

(StandardItems)
預設值。
樣式：小型影像和取消強調的文字。
StandardItems 按鈕的螢幕擷取畫面。
(MajorItems)
樣式：大型影像和粗體文字。

注意：
如果 MenuGroup 是 ApplicationMenu的子系，則會忽略 Class 屬性，而且 架構會強制執行 的 MajorItems 樣式。


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 命令宣告。 也會宣告做為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
  • 可以是空的：否

另請參閱

指定功能區映射資源

功能表群組