ツール バー コントロール (MSAA UI 要素リファレンス)

  • [アーティクル]

Note

このトピックでは、MSAA UI 要素リファレンスを目的とした ツール バー コントロール オブジェクトについて説明します。 さまざまな UI フレームワークで ツール バー コントロール オブジェクトを作成する方法については、ここでは説明しません。 使用している UI フレームワークの API リファレンス ドキュメントを参照してください。

ツール バー コントロールには、メニュー コマンドを実行するボタンが含まれており、通常はメニュー バーの下のウィンドウに含まれます。

ツール バー コントロールのウィンドウ クラス名は TOOLBARCLASSNAME で、Commctrl.h では "ToolbarWindow32" として定義されています。

IAccessible メソッド

ツール バー コントロールでは、次の IAccessible メソッドがサポートされています。

メソッド 説明
accDoDefaultAction ツール バー自体は accDoDefaultAction メソッドをサポートしています。 ツール バーのボタンに対して、 accDoDefaultAction は PostMessage を呼び出し、 BM_CLICK メッセージを使用して指定したボタンをクリックします。
accHitTest
accLocation
accNavigate
accSelect

IAccessible プロパティ

ツール バー コントロールでは、次の IAccessible プロパティが サポートされています。

プロパティ 説明
get_accChild
get_accChildCount ChildCount プロパティは、ツール バーに含まれるコントロールの数です。
get_accDefaultAction ツール バー オブジェクト自体には DefaultAction プロパティがありません。 ツール バー ボタンの DefaultAction プロパティは、ツール バー ボタンのスタイルによって異なります。 スタイルを持つボタンTBSTYLE_DROPDOWN DefaultAction プロパティとして "開く" があります。 他のすべてのツール バー ボタンの DefaultAction プロパティは、"Press" です。
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut ツール バーにはキーボード ショートカットがありません。 ただし、ツール バーのウィンドウ テキストにアンパサンド (&) 文字が含まれている場合、Microsoft Active Accessibility は KeyboardShortcut プロパティとして Null 以外の文字列を返します。
get_accName ツール バーの Name プロパティは、コントロールのウィンドウ テキスト (またはキャプション) から取得されます。 このテキストはツール バーに表示されないため、サーバー開発者は、クライアント ユーティリティのユーザーがコントロールを識別できるように、コントロールのリソース定義ステートメントに意味のあるテキストを指定する必要があります。 ウィンドウ テキストは、 SetWindowText 関数を使用して設定できます。
get_accParent Parent プロパティは、コントロールを囲み、コントロールと同じ Name プロパティとウィンドウ クラス名を持つウィンドウ ( ROLE_SYSTEM_WINDOW ) です。
get_accRole Role プロパティがROLE_SYSTEM_TOOLBAR。
get_accSelection
get_accState ツール バー自体の State プロパティの値は 0 です。これは、オブジェクトが表示されていることを意味します。 ツール バー ボタンの State プロパティに使用できる値は、 STATE_SYSTEM_INVISIBLE または です。
| STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_MOVEABLE | STATE_SYSTEM_FOCUSEDSTATE_SYSTEM_FOCUSABLE

Notes

ツール バーのボタンは、 EVENT_OBJECT_STATECHANGE イベントを送信します。

IAccessible インターフェイス