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>

属性

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

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

(xs:positiveInteger または xs:string)
文字列、2 ~ 59999 の整数値、または 0x2 から 0xea5f までの 16 進数の値 (両端を含む)。
値は、リボン XML ドキュメント内で一意である必要があります。
最大長: 100 文字。
HasLargeItems
ブール型
いいえ
コマンドの大きいイメージ リソースと小さいイメージ リソースをギャラリー コントロールに表示するかどうかを指定します。
[!注]
Type 属性の値が等しいCommandギャラリーにのみ適用されます。

次のいずれかの値に制限されます (0 と 1 は無効です)。

(true)
既定値。
(false)
ItemHeight
xs:integer
No
(xs:integer)
既定値は -1 です。
ItemWidth
xs:integer
No
(xs:integer)
既定値は -1 です。
TextPosition
TextPositionType
No
次のいずれかの値に制限されます。

(下)
(非表示)
(左)
(重複)
(右)
(上)
Type
xs:string
No
次のいずれかの値に制限されます。

(項目)
(コマンド)

子要素

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

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

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

SplitButtonGallery.MenuGroups
1 回だけ実行する必要があります

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

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

親要素

要素 説明
ControlGroup
グループ
MenuGroup
ApplicationMenu に含まれている場合。 この要素は最初のレベルでのみサポートされ、子要素は必要ありません。

QuickAccessToolbar.ApplicationDefaults
[!注]
Windows 8以降。


SplitButton

注釈

省略可能。

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

SplitButtonGallery では、 アプリケーション モードがサポートされています。

UI_PKEY_BooleanValue は、 SplitButtonGallery のボタン コントロールのトグル状態を照会するためにアプリケーションによって使用されます。

次のスクリーン ショットは、Windows 7 のMicrosoft ペイントのリボン分割ボタン ギャラリー コントロールを示しています。

screen shot of a split button gallery control in microsoft paint for windows 7.

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

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

ギャラリーのサンプル