リスト ボックス (MSAA UI 要素リファレンス)
注意
このトピックでは、MSAA UI 要素リファレンスを目的とした List Box オブジェクトについて説明します。 さまざまな UI フレームワークで List Box オブジェクトを作成する方法については、ここでは説明しません。 使用している UI フレームワークの API リファレンス ドキュメントを参照してください。
リスト ボックスには、ユーザーが 1 つ以上の項目を選択できるリストが表示されます。 リスト ボックスは、垂直スクロール バー、水平コントロール バー、またはその両方で作成されます。
リスト ボックスのウィンドウ クラス名は "LISTBOX" です。
リスト ボックスでは、次の IAccessible メソッドがサポートされています。
メソッド | 説明 |
---|---|
accDoDefaultAction | リスト ボックス オブジェクト自体には DefaultAction プロパティがありません。ただし、 accDoDefaultAction は リスト ボックス項目をダブルクリックします。 |
accHitTest | accHitTest メソッドは、テスト対象のポイントがリスト ボックス内にあるが、リスト ボックス内の項目には含まれていない場合、0 を返します。 テスト対象のポイントがリスト ボックス内の項目にある場合、 accHitTest はリスト ボックス項目のインデックスを返します。 |
accLocation | |
accNavigate | |
accSelect |
リスト ボックスでは、次の IAccessible プロパティが サポートされています。
プロパティ | 説明 |
---|---|
get_accChild | ChildCount プロパティは、リスト ボックス内の項目の数です。 |
get_accDefaultAction | リスト ボックス オブジェクト自体には DefaultAction プロパティがありません。ただし、各リスト アイテムの DefaultAction プロパティは "ダブルクリック" です。 |
get_accDescription | |
get_accFocus | |
get_accHelp | |
get_accHelpTopic | |
get_accKeyboardShortcut | KeyboardShortcut プロパティはリスト ボックス アクセス キーです。これは、リスト ボックスに関連付けられているラベルのテキストの下線付きの文字です。 返される文字列には、文字列 "Alt +" に追加されたアクセス キー文字が含まれています。 |
get_accName | リスト ボックス オブジェクトの Name プロパティは、リスト ボックスにラベルを付ける静的テキスト コントロールのテキストです。 リスト ボックス項目の場合、 Name プロパティはリスト アイテムのテキストです。 |
get_accParent | Parent プロパティは、リスト ボックスを囲み、リスト ボックスと同じ Name プロパティとウィンドウ クラス名を持つウィンドウ ( ROLE_SYSTEM_WINDOW ) です。 リスト ボックス項目の Parent プロパティは、リスト ボックス オブジェクトです。 |
get_accRole | Role プロパティがROLE_SYSTEM_LIST。 リスト ボックスの項目には、ROLE_SYSTEM_LISTITEMの Role プロパティがあります。 |
get_accSelection | Selection プロパティは、リスト ボックスで選択した項目を取得します。 |
get_accState | リスト ボックス オブジェクトの State プロパティは、次の値の 1 つ以上の組み合わせです。STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN | リスト ボックス項目の State プロパティは、次の 1 つ以上の値の組み合わせです。 | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_OFFSCREENSTATE_SYSTEM_NORMAL |