Role プロパティ

Role プロパティは、オブジェクトのユーザー インターフェイス要素を表します。 すべてのオブジェクトは、Role プロパティをサポートします。

多くの場合、オブジェクトの役割は明らかです。 たとえば、ウィンドウには ROLE_SYSTEM_WINDOW ロールがあり、プッシュ ボタンには ROLE_SYSTEM_PUSHBUTTON ロールがあります。

Role プロパティは、IAccessible::get_accRoleを呼び出すことによって取得されます。

オブジェクトのロールの識別

Microsoft Active Accessibility には、oleacc.h で定義 ロール定数が用意されています。これは、共通のオブジェクト ロールを識別します。 サーバー開発者は、これらの定義済みのロール値を使用することをお勧めします。 定義済みのロール定数が返された場合、クライアントは GetRoleText 関数を使用して、ロールを記述するローカライズされた文字列を取得します。

ファイルのコピー時に表示されるアニメーション コントロールなどのアニメーション コントロールの場合は、ROLE_SYSTEM_ANIMATIONを使用します。 時々アニメーション化されるグラフィックスは、State プロパティが STATE_SYSTEM_ANIMATEDに設定された ROLE_SYSTEM_GRAPHIC として記述されます。

一部のロールは説明が簡単ではないことに注意してください。 たとえば、フォルダーの大きなアイコン ビューを使用すると、アイコンを任意に配置できるため、その役割は ROLE_SYSTEM_GROUPINGとして記述できます。 または、固定行と列の項目を提供するコントロールには、ROLE_SYSTEM_TABLE ロールを持つことができます。 ロールは使用モデルをエンド ユーザーに伝えるために使用されるため、適切なロールを使用することが重要です。 たとえば、コントロールがボタンのように機能する場合は、ROLE_SYSTEM_PUSHBUTTONを使用します。