次の方法で共有

[分割] ボタン

  • [アーティクル]

分割ボタンは、ユーザーがプライマリ ボタンにバインドされた既定値を選択したり、セカンダリ ボタンにバインドされたドロップダウン リストに表示される相互排他的な値の一覧から選択したりできる複合コントロールです。

紹介

このコントロールは、明確な既定値が使用でき、個々の項目を画像、テキスト、またはその両方で表すことができる場合に、密接に関連する項目を公開する場合に役立ちます。

次のスクリーン ショットは、リボン分割ボタンを示しています。

サンプル リボンの分割ボタン コントロールのスクリーン ショットを します。

分割ボタンのプロパティ

リボン フレームワークは、分割ボタン コントロールに プロパティ キーのコレクションを定義します。

通常、分割ボタン プロパティは、IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられているコマンドを無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、IUICommandHandler::UpdateProperty コールバック メソッドによってプロパティが更新されます。

IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションは、フレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブになり、リボン UI にコントロールが表示されたときや、ツールヒントが表示されたときなどです。

手記

場合によっては、IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、IUIFramework::SetUICommandProperty メソッドで設定できます。

次の表に、分割ボタン コントロールに関連付けられているプロパティ キーの一覧を示します。

プロパティ キー 筆記
UI_PKEY_Enabled IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。
すべての子項目が無効になっている場合、フレームワークは UI_PKEY_Enabled を false (0) に設定します。 それ以外の場合、1 つ以上の子項目が有効になっている場合、UI_PKEY_Enabledは true (-1) に設定されます。 重要:
分割ボタン コントロールの UI_PKEY_Enabled プロパティは、1 つ以上の子項目が有効または無効になった後に無効にする必要があります。 これにより、フレームワークは更新されたプロパティ値に対してクエリを実行し、リボン UI の分割ボタン コントロールの状態を更新します。
UI_PKEY_Keytip 無効化によってのみ更新できます。
UI_PKEY_TooltipDescription 無効化によってのみ更新できます。
UI_PKEY_TooltipTitle 無効化によってのみ更新できます。

Windows リボン フレームワーク コントロール ライブラリ の

SplitButton マークアップ要素