オブジェクト ロール

このトピックでは、アプリケーション内のさまざまな UI オブジェクトの役割を説明するために使用される定数値について説明します。 ロール定数は、Oleacc.h ファイルで定義されます。

ここに記載されているロール定数のみを使用する必要があります。定義済みでないカスタム ロールまたはロールを追加しないでください。

これらのオブジェクト ロールを使用する前に、クライアント アプリケーションの開発者は Inspect ツールを使用して、オブジェクト ロールが UI 要素によって使用されていることを確認する必要があります。

オブジェクトのロールを取得するには、クライアントは IAccessible::get_accRole メソッドを呼び出します。このメソッドは、テーブルで説明されている値のいずれかを返す必要があります。 オブジェクトのロールを記述するローカライズされた文字列を取得するために、クライアントはロール値を使用 して GetRoleText 関数を呼び出します。 ロール値のローカライズされた文字列は、oleaccrc.dll ファイルにあります。

定数	説明
ROLE_SYSTEM_ALERT	オブジェクトは、ユーザーに通知する必要があるアラートまたは条件を表します。 このロールは、アラートを具体化するが、メッセージ ボックス、グラフィック、テキスト、サウンドなどの別のユーザー インターフェイス要素に関連付けられていないオブジェクトにのみ使用されます。
ROLE_SYSTEM_ANIMATION	オブジェクトは、一連のビットマップ フレームを表示するコントロールなど、コンテンツが時間の経過と同時に変化するアニメーション コントロールを表します。 アニメーション コントロールは、ファイルがコピーされたとき、または他の時間のかかるタスクが実行されるときに表示されます。
ROLE_SYSTEM_APPLICATION	オブジェクトは、アプリケーションのメイン ウィンドウを表します。
ROLE_SYSTEM_BORDER	オブジェクトはウィンドウの境界線を表します。 境界線全体は、各辺の個別のオブジェクトではなく、1 つのオブジェクトで表されます。
ROLE_SYSTEM_BUTTONDROPDOWN	オブジェクトは、項目のリストを展開するボタンを表します。
ROLE_SYSTEM_BUTTONDROPDOWNGRID	オブジェクトは、グリッドを展開するボタンを表します。
ROLE_SYSTEM_BUTTONMENU	オブジェクトは、メニューを展開するボタンを表します。
ROLE_SYSTEM_CARET	オブジェクトはシステム キャレットを表します。
ROLE_SYSTEM_CELL	オブジェクトは、テーブル内のセルを表します。
ROLE_SYSTEM_CHARACTER	オブジェクトは、Microsoft Office Assistant などの漫画のようなグラフィック オブジェクトを表します。このオブジェクトは、アプリケーションのユーザーにヘルプを提供するために表示されます。
ROLE_SYSTEM_CHART	オブジェクトは、データのグラフ作成に使用されるグラフィカル イメージを表します。
ROLE_SYSTEM_CHECKBUTTON	オブジェクトは、チェック ボックス コントロールを表します。これは、他のオプションとは別に選択またはクリアされるオプションです。
ROLE_SYSTEM_CLIENT	オブジェクトは、ウィンドウのクライアント領域を表します。 UI 要素のロールに関する質問がある場合、Microsoft Active Accessibility はこのロールを既定として使用します。
ROLE_SYSTEM_CLOCK	オブジェクトは、時間を表示するコントロールを表します。
ROLE_SYSTEM_COLUMN	オブジェクトは、テーブル内のセルの列を表します。
ROLE_SYSTEM_COLUMNHEADER	オブジェクトは列ヘッダーを表し、テーブル内の列の視覚的なラベルを提供します。
ROLE_SYSTEM_COMBOBOX	オブジェクトはコンボ ボックスを表します。定義済みの選択肢のセットを提供する、関連付けられたリスト ボックスを持つ編集コントロールです。
ROLE_SYSTEM_CURSOR	オブジェクトは、システムのマウス ポインターを表します。
ROLE_SYSTEM_DIAGRAM	オブジェクトは、データのダイアグラムに使用されるグラフィカル イメージを表します。
ROLE_SYSTEM_DIAL	オブジェクトは、ダイヤルまたはノブを表します。
ROLE_SYSTEM_DIALOG	オブジェクトは、ダイアログ ボックスまたはメッセージ ボックスを表します。
ROLE_SYSTEM_DOCUMENT	オブジェクトはドキュメント ウィンドウを表します。 ドキュメント ウィンドウは常にアプリケーション ウィンドウ内に含まれます。 このロールは MDI ウィンドウにのみ適用され、MDI タイトル バーを含むオブジェクトを参照します。
ROLE_SYSTEM_DROPLIST	オブジェクトは、カレンダー コントロール SysDateTimePick32 を表します。 Microsoft Active Accessibility ランタイム コンポーネントは、このロールを使用して、日付またはカレンダー コントロールが見つかったことを示します。
ROLE_SYSTEM_EQUATION	オブジェクトは数式を表します。
ROLE_SYSTEM_GRAPHIC	オブジェクトは図を表します。
ROLE_SYSTEM_GRIP	オブジェクトは、ユーザーがウィンドウなどのユーザー インターフェイス要素を操作できるようにする特別なマウス ポインターを表します。 この例の 1 つは、右下隅をドラッグしてウィンドウのサイズを変更する場合です。
ROLE_SYSTEM_GROUPING	オブジェクトは、他のオブジェクトを論理的にグループ化します。 グループ化オブジェクトとそこに含まれるオブジェクトの間には、常に親子関係があるとは限りません。
ROLE_SYSTEM_HELPBALLOON	オブジェクトには、ヒントまたはヘルプ バルーンの形式でヘルプ トピックが表示されます。
ROLE_SYSTEM_HOTKEYFIELD	オブジェクトは、ユーザーがキーストロークの組み合わせまたはシーケンスを入力できるようにするキーボード ショートカット フィールドを表します。
ROLE_SYSTEM_INDICATOR	オブジェクトは、現在の項目を指すインジケーター (ポインター グラフィックなど) を表します。
ROLE_SYSTEM_IPADDRESS	オブジェクトは、IP アドレス用に設計された編集コントロールを表します。 編集コントロールは、IP アドレスの特定の部分ごとにセクションに分割されます。
ROLE_SYSTEM_LINK	オブジェクトは、他のリンクを表します。 このオブジェクトは、テキストやグラフィックのように見えることもありますが、ボタンに似た動作をします。
ROLE_SYSTEM_LIST	オブジェクトはリスト ボックスを表し、ユーザーは 1 つ以上の項目を選択できます。
ROLE_SYSTEM_LISTITEM	オブジェクトは、リスト ボックスまたはコンボ ボックス、ドロップダウン リスト ボックス、またはドロップダウン コンボ ボックスのリスト部分の項目を表します。
ROLE_SYSTEM_MENUBAR	オブジェクトは、ユーザーがメニューを選択するメニュー バー (ウィンドウのタイトル バーの下に配置) を表します。
ROLE_SYSTEM_MENUITEM	オブジェクトはメニュー項目を表します。ユーザーがコマンドの実行、オプションの選択、または別のメニューの表示を選択できるメニュー エントリです。 機能的には、メニュー項目は、プッシュ ボタン、ラジオ ボタン、チェック ボックス、またはメニューと同じです。
ROLE_SYSTEM_MENUPOPUP	オブジェクトはメニューを表します。各メニューは、特定のアクションを持つオプションの一覧です。 メニュー バーから選択すると表示されるドロップダウン メニューを含め、すべてのメニューの種類にロールが必要です。および ショートカット メニュー。マウスの右ボタンをクリックして表示されます。
ROLE_SYSTEM_OUTLINE	オブジェクトは、ツリー ビュー コントロールなどのアウトラインまたはツリー構造を表し、階層リストを表示し、ユーザーがブランチを展開および折りたたみできるようにします。
ROLE_SYSTEM_OUTLINEBUTTON	オブジェクトは、アウトライン項目のように移動する項目を表します。 上方向キーと下方向キーは、アウトライン内を移動するために使用されます。 ただし、左方向キーと右方向キーを押したときに展開と折りたたみを行う代わりに、SPACE キーまたは Enter キーを押したときに項目にフォーカスがあるときに、これらのメニューが展開または折りたたみされます。
ROLE_SYSTEM_OUTLINEITEM	オブジェクトは、アウトライン構造またはツリー構造の項目を表します。
ROLE_SYSTEM_PAGETAB	オブジェクトはページ タブを表します。ページ タブ コントロールの唯一の子は、関連付けられたページの内容を持つROLE_SYSTEM_GROUPING オブジェクトです。
ROLE_SYSTEM_PAGETABLIST	オブジェクトは、ページ タブ コントロールのコンテナーを表します。
ROLE_SYSTEM_PANE	オブジェクトは、フレームまたはドキュメント ウィンドウ内のペインを表します。 ユーザーは、ペイン間や現在のペインの内容の中は移動できますが、異なるペインの項目間は移動できません。 したがって、ペインは、フレームまたはドキュメント ウィンドウよりも低いが、個々のコントロールよりも高いグループ化レベルを表します。 ユーザーは、状況に応じて、TAB、F6、または CTRL + TAB キーを押すことによって、ペイン間を移動します。
ROLE_SYSTEM_PROGRESSBAR	オブジェクトは進行状況バーを表し、実行中の操作の完了量を動的に示します。 このコントロールは、ユーザー入力を受け取らなくなります。
ROLE_SYSTEM_PROPERTYPAGE	オブジェクトはプロパティ シートを表します。
ROLE_SYSTEM_PUSHBUTTON	オブジェクトは、プッシュ ボタン コントロールを表します。
ROLE_SYSTEM_RADIOBUTTON	オブジェクトは、オプション ボタン (以前はラジオ ボタン) を表します。 これは、相互に排他的なオプションのグループの 1 つです。 同じ親を共有し、この属性を持つすべてのオブジェクトは、相互に排他的な 1 つのグループの一部であると見なされます。 これらのオブジェクトを個別のグループに分割するには、ROLE_SYSTEM_GROUPING オブジェクトを使用します。
ROLE_SYSTEM_ROW	オブジェクトは、テーブル内のセルの行を表します。
ROLE_SYSTEM_ROWHEADER	オブジェクトは行ヘッダーを表し、テーブル行の視覚的なラベルを提供します。
ROLE_SYSTEM_SCROLLBAR	オブジェクトは、垂直または水平のスクロール バーを表します。これは、クライアント領域の一部であるか、コントロールで使用されます。
ROLE_SYSTEM_SEPARATOR	オブジェクトは、スペースを 2 つの領域に視覚的に分割するために使用されます。 区切り記号オブジェクトの例としては、区切り記号メニュー項目と、ウィンドウ内の分割ウィンドウを分割するバーがあります。
ROLE_SYSTEM_SLIDER	オブジェクトはスライダーを表します。これにより、ユーザーは、最小値と最大値の間で特定の増分で設定を調整できます。
ROLE_SYSTEM_SOUND	オブジェクトは、さまざまなシステム イベントに関連付けられているシステム サウンドを表します。
ROLE_SYSTEM_SPINBUTTON	オブジェクトはスピン ボックスを表します。これは、ユーザーがスピン ボックスに関連付けられている別の "バディ" コントロールに表示される値をインクリメントまたはデクリメントできるようにするコントロールです。
ROLE_SYSTEM_SPLITBUTTON	オブジェクトは、ボタンに直接隣接するドロップダウン リスト アイコンがあるツールバー上のボタンを表します。
ROLE_SYSTEM_STATICTEXT	オブジェクトは、他のコントロールのラベルやダイアログ ボックスの指示など、読み取り専用のテキストを表します。 静的テキストは変更または選択できません。
ROLE_SYSTEM_STATUSBAR	オブジェクトは、ウィンドウの下部にある領域であり、現在の操作、アプリケーションの状態、または選択したオブジェクトに関する情報を表示するステータス バーを表します。 ステータス バーには、さまざまな種類の情報を表示する複数のフィールドがあります。
ROLE_SYSTEM_TABLE	オブジェクトは、セルの行と列、および必要に応じて行ヘッダーと列ヘッダーを含むテーブルを表します。
ROLE_SYSTEM_TEXT	オブジェクトは、編集を許可する選択可能なテキストを表すか、読み取り専用として指定されます。
ROLE_SYSTEM_TITLEBAR	オブジェクトは、ウィンドウのタイトルまたはキャプションバーを表します。
ROLE_SYSTEM_TOOLBAR	オブジェクトはツールバーを表します。これは、頻繁に使用される機能に簡単にアクセスできるコントロールのグループです。
ROLE_SYSTEM_TOOLTIP	オブジェクトは、役に立つヒントを提供するツールヒントを表します。
ROLE_SYSTEM_WHITESPACE	オブジェクトは、他のオブジェクト間の空白を表します。
ROLE_SYSTEM_WINDOW	オブジェクトはウィンドウ フレームを表します。このフレームには、タイトル バー、クライアント、ウィンドウのその他のオブジェクトなどの子オブジェクトが含まれます。

要件

要件	値
ヘッダー	Oleacc.h