SplitButton 要素

標準の 分割ボタン コントロールを 表します。

使用法

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

属性

属性 Type 必須 Description
ApplicationModes
xs:string
いいえ
MenuGroup が親要素の場合にのみ有効です。

(xs:string)
0 ~ 31 の整数のコンマ区切りのリストを含む文字列。
空白は有効であり、無視されます。
最大長: 250 文字。
CommandName
xs:positiveInteger または xs:string
いいえ
要素を Command に関連付 けます

(xs:positiveInteger または xs:string)
文字列、2 ~ 59999 の整数値、または 0x2 から 0xea5f までの 16 進数の値 (両端を含む)。
値は、リボン XML ドキュメント内で一意である必要があります。
最大長: 100 文字。

子要素

要素 説明
Button
1 回以上発生する可能性がある

CheckBox
1 回以上発生する可能性がある

DropDownButton
1 回以上発生する可能性がある

DropDownColorPicker
1 回以上発生する可能性がある

DropDownGallery
1 回以上発生する可能性がある

SplitButton
1 回以上発生する可能性がある

SplitButton.ButtonItem
最大で 1 回発生する可能性があります

SplitButton.MenuGroups
最大で 1 回発生する可能性があります

SplitButtonGallery
1 回以上発生する可能性がある

ToggleButton
1 回以上発生する可能性がある

親要素

要素
ControlGroup
DropDownGallery
グループ
MenuGroup
SplitButton
SplitButtonGallery

解説

省略可能。

ControlGroupDropDownGalleryGroupMenuGroup、SplitButton、または SplitButtonGallery 要素ごとに 1 回以上発生する可能性があります。

SplitButton は、 アプリケーション メニューの左側の列でホストされている場合に、アプリケーション モードをサポートします。

DropDownGallerySplitButtonGallery は、DropDownButtonApplicationMenu の子孫である場合、DropDownButton の有効な子要素ではありません。

SplitButton の子要素として以下が存在しない場合は、SplitButton.MenuGroups が 1 回発生する必要があります。

これらのコントロールは、単一の既定の SplitButton.MenuGroups 要素の子要素として扱われます。

次の例では、 分割ボタンの基本的なマークアップを示します。

このコード セクションでは、SplitButton コマンド宣言と、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"/>

コードのこのセクションでは、 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