SplitButtonGallery 元素

表示具有基于库的下拉菜单的 拆分按钮库 控件。

使用情况

<SplitButtonGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</SplitButtonGallery>

属性

属性	类型	必须	说明
ApplicationModes	xs:string	否	仅当 MenuGroup 是父元素时有效。 (xs：string) 包含 0 到 31 之间的整数的逗号分隔列表的字符串。 空格有效且将被忽略。 最大长度：250 个字符。
CommandName	xs：positiveInteger 或 xs：string	否	将 元素与 Command 相关联。 (xs：positiveInteger 或 xs：string) 一个字符串，一个介于 2 和 59999 之间的整数值（含），或介于 0x2 和 0xea5f 之间的十六进制值（含）。 该值在功能区 XML 文档中必须是唯一的。 最大长度：100 个字符。
HasLargeItems	布尔	否	确定命令的大图像资源还是小图像资源显示在库控件中。 注意： 仅适用于 Type 属性的值等于 Command的库。 限制为以下值之一 (0 和 1) 无效： (true) 默认。 (false)
ItemHeight	xs:integer	否	(xs：integer) 默认值为 -1。
ItemWidth	xs:integer	否	(xs：integer) 默认值为 -1。
TextPosition	TextPositionType	否	限制为以下值之一： (底部) (隐藏) (左) (重叠) (右) (顶级)
Type	xs:string	否	限制为以下值之一： (项) (命令)

子元素

元素	说明
Button	可能发生一次或多次
CheckBox	可能发生一次或多次
SplitButton	可能发生一次或多次
SplitButtonGallery.MenuGroups	必须恰好发生一次
SplitButtonGallery.MenuLayout	最多可以发生一次
ToggleButton	可能发生一次或多次

父元素

元素	说明
ControlGroup
组
MenuGroup	当包含在 ApplicationMenu 中时。 此元素仅在第一级受支持，并且必须没有子元素。
QuickAccessToolbar.ApplicationDefaults	注意： Windows 8 及更新版本。
SplitButton

注解

可选。

对于每个 ControlGroup、 Group、 MenuGroup 或 SplitButton 元素，可能会发生一次或多次。

SplitButtonGallery 支持 应用程序模式。

UI_PKEY_BooleanValue 由应用程序用来查询 SplitButtonGallery 的按钮控件的切换状态。

以下屏幕截图演示了 windows 7 Microsoft 画图 中的功能区拆分按钮库控件。

示例

以下示例演示 拆分按钮库的基本标记。

此代码部分显示 SplitButtonGallery Command 声明，其中包含一个关联的 Group，该 组 充当 SplitButtonGallery 元素的父容器。

<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

此代码部分显示 SplitButtonGallery 控件声明。

<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

元素信息

• 支持的最低系统：Windows 7
• 可以为空：否

请参阅

拆分按钮库控件

使用库

SetModes

库示例