オブジェクト状態定数

このトピックでは、アプリケーション UI のオブジェクトの状態を記述するために使用される定数値について説明します。 状態定数は oleacc.h で定義されています。

オブジェクトは、これらの状態値の 1 つ以上にいつでも関連付けられます。 STATE_SYSTEM_ALERT_HIGH、STATE_SYSTEM_ALERT_MEDIUM、STATE_SYSTEM_ALERT_LOW、およびSTATE_SYSTEM_FLOATINGのオブジェクト状態定数は使用されません。

クライアントは、次のビット フラグの組み合わせである整数 返す IAccessible::get_accStateを呼び出して、オブジェクトの状態を取得します。 クライアントは、状態値 GetStateText を呼び出して、オブジェクトの状態を記述するローカライズされた文字列を取得します。

オブジェクトの状態が変わると、サーバーは EVENT_OBJECT_STATECHANGE イベント定数 NotifyWinEvent を呼び出す必要があります。 ただし、STATE_SYSTEM_INVISIBLE、STATE_SYSTEM_FOCUSED、およびSTATE_SYSTEM_ SELECTED オブジェクト状態定数を持つオブジェクトには、独自のイベント定数があります。 これらのオブジェクトの場合は、EVENT_OBJECT_STATECHANGEを使用しないでください。 代わりに、個々のイベント定数を使用します。

オブジェクト状態定数を次に示します。

定数	形容
STATE_SYSTEM_ALERT_HIGH 0x10000000	(このオブジェクト状態定数はサポートされていません)。 ユーザーにすぐに伝える重要な情報を示します。 たとえば、バッテリが非常に低いレベルに達すると、レベル インジケーターによって高レベルのアラートが生成されます。 その結果、ブラインド アクセス ツールはすぐにこの情報をユーザーに読み上げ、画面倍率プログラムはバッテリー インジケーターが表示されるように画面をスクロールします。 この状態は、ユーザーが続行する前に完了する必要があるプロンプトまたは操作にも適しています。
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(このオブジェクト状態定数はサポートされていません)。 ユーザーにすぐに伝達されない重要な情報を示します。 たとえば、バッテリが低レベルに達し始めると、レベル インジケーターによって中レベルのアラートが生成されます。 その後、ブラインド アクセス ツールは、ユーザーの作業を実際に中断することなく、重要な情報が使用可能であることをユーザーに知らせるサウンドを生成します。 その後、ユーザーは、都合の良いときにアラート情報に対してクエリを実行できます。
STATE_SYSTEM_ALERT_LOW 0x4000000	(このオブジェクト状態定数はサポートされていません)。 ユーザーにとって重要ではない優先順位の低い情報を示します。 この状態は、たとえば、Word がツール バーの TipWizard ボタンの外観を変更して、ユーザーのヒントがあることを示すために使用されます。
STATE_SYSTEM_ANIMATED 0x4000	オブジェクトの外観は、急速または絶えず変化します。 時々アニメーション化されるグラフィックスは、State プロパティがSTATE_SYSTEM_ANIMATEDに設定された ROLE_SYSTEM_GRAPHIC として記述されます。 この状態は、オブジェクトの場所が変更されていることを示すために使用されます。
STATE_SYSTEM_BUSY 0x800	この時点では、コントロールは入力を受け入れることができません。
STATE_SYSTEM_CHECKED 0x10	オブジェクトのチェック ボックスがオンになっています。
STATE_SYSTEM_COLLAPSED 0x400	ROLE_SYSTEM_OUTLINEITEM ロールを持つオブジェクトの子は非表示になります。
STATE_SYSTEM_DEFAULT 0x100	この状態は、ウィンドウ内の既定のボタンを表します。
STATE_SYSTEM_EXPANDED 0x200	ROLE_SYSTEM_OUTLINEITEM ロールを持つオブジェクトの子が表示されます。
STATE_SYSTEM_EXTSELECTABLE 0x2000000	オブジェクトが IAccessible::accSelect メソッドの SELFLAG_EXTENDSELECTION を使用して選択範囲を拡張することを示します。
STATE_SYSTEM_FLOATING 0x1000	(このオブジェクト状態定数はサポートされていません)。 オブジェクトは親オブジェクトの境界にクリップされず、親が移動しても自動的には移動しません。
STATE_SYSTEM_FOCUSABLE 0x100000	オブジェクトはアクティブウィンドウ上にあり、キーボードフォーカスを受け取る準備ができています。
STATE_SYSTEM_FOCUSED 0x4	オブジェクトにはキーボード フォーカスがあります。 オブジェクトのフォーカスとオブジェクトの選択を混同しないでください。 詳細については、「選択とフォーカスのプロパティとメソッドのを参照してください。 このオブジェクトの状態を持つオブジェクトの場合は、EVENT_OBJECT_SHOW または EVENT_OBJECT_HIDE WinEvents を送信して、状態の変更についてクライアント アプリケーションに通知します。 EVENT_OBJECT_STATECHANGEは使用しないでください。
STATE_SYSTEM_HASPOPUP 0x40000000	呼び出されると、オブジェクトにポップアップ メニューまたはウィンドウが表示されます。
STATE_SYSTEM_HOTTRACKED 0x80	オブジェクトはマウスによってホット トラッキングされます。つまり、オブジェクトの外観が変更され、その上にマウス ポインターが配置されていることを示します。
STATE_SYSTEM_INVISIBLE 0x8000	オブジェクトはプログラムによって非表示になります。 たとえば、ユーザーがメニューをアクティブ化するまで、メニュー のメッセージはプログラムによって非表示になります。 この状態のオブジェクトはユーザーが使用できないため、クライアント アプリケーションはオブジェクトに関する情報をユーザーに伝えてはなりません。 ただし、クライアント アプリケーションがこの状態のオブジェクトを見つけた場合は、STATE_SYSTEM_OFFSCREENも設定されているかどうかを確認する必要があります。 この 2 番目の状態が定義されている場合、クライアントはオブジェクトに関する情報をユーザーに伝えることができます。 たとえば、リスト ボックスには、STATE_SYSTEM_INVISIBLEとSTATE_SYSTEM_OFFSCREENの両方を設定できます。 この場合、クライアント アプリケーションは、リスト内のすべての項目をユーザーに伝えることができます。 クライアント アプリケーションが IAccessible ツリー内を移動していて、非表示の親オブジェクトが検出された場合、Microsoft Active Accessibility は、親が非表示である限り、親の可能な子に関する情報を公開しません。
STATE_SYSTEM_LINKED 0x400000	オブジェクトがハイパーリンクとして書式設定されていることを示します。 通常、オブジェクトのロールは ROLE_SYSTEM_TEXTされます。
STATE_SYSTEM_MARQUEED 0x2000	テキストまたはグラフィックスのスクロールまたは移動を示します。
STATE_SYSTEM_MIXED 0x20	3 状態チェック ボックスまたはツール バー ボタンの状態が決定されないことを示します。 チェック ボックスは選択もクリアもされていないため、3 番目または 混在 状態になります。
STATE_SYSTEM_MOVEABLE 0x40000	オブジェクトを移動できることを示します。 たとえば、ユーザーはオブジェクトのタイトル バーをクリックし、オブジェクトを新しい場所にドラッグできます。
STATE_SYSTEM_MULTISELECTABLE 0x1000000	オブジェクトが複数の選択された項目を受け入れることを示します。つまり、IAccessible::accSelect メソッドの SELFLAG_ADDSELECTION が有効です。
STATE_SYSTEM_NORMAL 0	オブジェクトに別の状態が割り当てされていないことを示します。
STATE_SYSTEM_OFFSCREEN 0x10000	オブジェクトはクリップされるか、表示外にスクロールされていますが、プログラムによって非表示になりません。 ユーザーがビューポートを大きくすると、より多くのオブジェクトがコンピューター画面に表示されます。
STATE_SYSTEM_PRESSED 0x8	オブジェクトが押されます。
STATE_SYSTEM_PROTECTED 0x20000000	オブジェクトは、パスワードで保護された編集コントロールです。
STATE_SYSTEM_READONLY 0x40	オブジェクトは読み取り専用として指定されます。
STATE_SYSTEM_SELECTABLE 0x200000	オブジェクトは選択を受け入れます。
STATE_SYSTEM_SELECTED 0x2	オブジェクトが選択されています。
STATE_SYSTEM_SELFVOICING 0x80000	オブジェクトまたは子は、説明のためにテキスト読み上げ (TTS) テクノロジを使用します。 この状態のオブジェクトにフォーカスがある場合、オブジェクトが自動的に読み上げるため、音声ベースのアクセシビリティ 支援では情報は読み上げされません。
STATE_SYSTEM_SIZEABLE 0x20000	オブジェクトのサイズを変更できます。 たとえば、ユーザーがウィンドウのサイズを変更するには、ウィンドウを境界線でドラッグします。
STATE_SYSTEM_TRAVERSED 0x800000	オブジェクトは、ユーザーがアクセス (以前にクリック) したハイパーリンクです。
STATE_SYSTEM_UNAVAILABLE 0x1	オブジェクトは使用できません。

必要条件

要件	価値
ヘッダ	Oleacc.h