SplitButton 元素

表示标准的 拆分按钮 控件。

使用情况

<SplitButton
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</SplitButton>

特性

属性	类型	必选	说明
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 个字符。

子元素

元素	说明
Button	可能发生一次或多次
CheckBox	可能发生一次或多次
DropDownButton	可能发生一次或多次
DropDownColorPicker	可能发生一次或多次
DropDownGallery	可能发生一次或多次
SplitButton	可能发生一次或多次
SplitButton.ButtonItem	最多可以发生一次
SplitButton.MenuGroups	最多可以发生一次
SplitButtonGallery	可能发生一次或多次
ToggleButton	可能发生一次或多次

父元素

元素
ControlGroup
DropDownGallery
组
MenuGroup
SplitButton
SplitButtonGallery

备注

可选。

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

当 SplitButton 托管在应用程序菜单的左列中时，它支持应用程序 模式 。

当 DropDownButton 是 ApplicationMenu 的后代时，DropDownGallery 和 SplitButtonGallery 不是 DropDownButton 的有效子元素。

如果 SplitButton 的子元素不存在下列项，则必须发生一次 SplitButton.MenuGroups：

• 按钮
• CheckBox
• DropDownButton
• DropDownColorPicker
• DropDownGallery
• SplitButton
• SplitButtonGallery
• ToggleButton

这些控件被视为单个默认 SplitButton.MenuGroups 元素的 子元素。

示例

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

此代码部分显示 SplitButton 命令声明，其中包含一个关联的 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 控件声明。

<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
• 可以为空：否

另请参阅

拆分按钮控件

SetModes