SplitButton 要素

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

使用法

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

属性

属性 Type 必須 説明
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 では、 アプリケーション メニューの左側の列でホストされているアプリケーション モードがサポートされます。

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

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

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

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

このコードセクションでは、 SplitButton 要素の親コンテナーとして機能する関連付けられた グループ を含む 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