トグル ボタン ツールは、ワード プロセッシング アプリケーションの、太字、斜体、下線などのフォント スタイルと同義です。このボタンをクリックすると関連付けられたアクションが発生します。これは通常、True または False の 2 つの値に設定できるブール プロパティです。ワープロアプリケーションでは、一部のテキストを強調表示したり [太字] ボタンをクリックします。選択したテキストが太字である限り、ボタンは選択した状態のままになり、これはチェックボックス タイプのコントロールと非常に似ています。チェックボックス コントロールのように、エンド ユーザーはトグル ボタンツールをチェックされた状態、チェックを解除された状態、または中間の状態にすることができます。
Toggle Button ツールは、Microsoft® Windows® Presentation Foundation の System.Windows.Controls ToggleButton クラスから派生します。したがって、標準の Windows Presentation Foundation トグル ボタンと同じ機能をすべて得られます。トグル ボタン ツールは IRibbonTool インターフェイスも実装します。これは、高度な xamRibbon™ 機能を促進するクローンおよびバインド機能を追加します。ユーザー独自のカスタム xamRibbon ツールを作成していなければ、IRibbonTool インターフェイスについての心配は不要です。
ToggleButtonTool クラスは、xamRibbon でボタンを容易に管理する上で役立つ複数の追加プロパティを公開します。ToggleButtonTool は、プロパティが設定されているかどうか、またはトグル ボタンが特定の状態にあるかどうかの確認を手助けするために複数の 'Has' および 'Is' プロパティを公開します。xamRibbon で Toggle Button ツール (または他のツール) を設定する手助けをする標準プロパティには以下が含まれます。
Caption - ツールのキャプションが表示可能である状態にツールのサイズが設定されている場合、ツールの隣りにこのテキストが表示されます。
Id - 異なる複数の場所 (つまり、リボン グループとクイック アクセス ツールバーに同時に) に配置された時にツールを関連付けるために xamRibbon が使用する識別文字列。Id は不要ですが、ランタイムに ツールにアクセスする手助けとなります。
KeyTip - 各ツールには、それに関連付けられた キーチップがあります (メイン メニュー ニーモニックに似ている)。明示的にキーチップを提供しなければ、ユーザーに代わって xamRibbon が内部的に選択します。
LargeImage - 通常は 32 x 32 ピクセルの画像です。ツールの SizingMode が ImageAndTextLarge に設定される場合にこの画像が表示されます。
SizingMode - このプロパティは読み取り専用で、ツールが関連付けられたリボン グループで現在どのようにサイズ設定されているかを返します。ツールのサイズを設定したい場合、RibbonGroup の MinimumSize および/または MaximumSize 添付プロパティを設定できます。また、 ボタン グループにツールを配置する場合、ツールは自動的に ImageOnly にサイズ設定されます。
SmallImage - 通常は 16 x 16 ピクセルの画像です。ツールの SizingMode が ImageAndTextNormal に設定される場合にこの画像が表示されます。
xamRibbon ツールすべては同じオブジェクトから派生および実装するので、ツールの各機能は非常に似ています。以下のトピックはすべての xamRibbon ツールに適用されます。