手記
このトピックでは、MSAA UI 要素リファレンスの目的 スクロール バー オブジェクトについて説明します。 ここでは、さまざまな UI フレームワーク オブジェクト スクロール バーを作成する方法について説明しません。 使用している UI フレームワークの API リファレンス ドキュメントを参照してください。
スクロール バーを使用すると、ユーザーは、関連するウィンドウまたはリスト ボックス内の情報をスクロールする方向と距離を選択できます。 スクロール バーのウィンドウ クラス名は "SCROLLBAR" です。
IAccessible プロパティの内容は、スクロール バーが垂直か水平か、およびスクロール バーの次のどの部分がクライアントによってクエリされているかによって異なります。
- スクロール バー自体
- 上矢印または右矢印ボタン
- 下矢印ボタンまたは左矢印ボタン
- スクロール ボックス (つまみ)
- ページの上またはページの右側の領域
- ページの下またはページの左側の領域
IAccessible メソッド
スクロール バーでは、IAccessibleメソッド次のものがサポートされています。
accDoDefaultAction—スクロール バー オブジェクト自体とスクロールサムは、accDoDefaultAction メソッドをサポートしていません。
垂直スクロール バー上の他のスクロール バー部分の場合、accDoDefaultActionは、wParam が次の値に設定された WM_VSCROLL メッセージを使用して、PostMessage を呼び出します。
ボタン/リージョン Vaule 上矢印ボタン SB_LINEUP 下矢印ボタン SB_LINEDOWN ページアップリージョン SB_PAGEUP ページダウン領域 SB_PAGEDOWN 水平スクロール バーのその他のスクロール バー部分の場合、accDoDefaultActionは、wParam が次の値に設定された WM_HSCROLL メッセージ PostMessage を呼び出します。
ボタン/リージョン 価値 左矢印ボタン SB_LINELEFT 右矢印ボタン SB_LINERIGHT ページの左側の領域 SB_PAGELEFT ページの右側の領域 SB_PAGERIGHT accHitTestをする
accLocationの
accNavigateをする
IAccessible プロパティ
スクロール バーは、IAccessibleプロパティ次の機能をサポートします。
get_accChildCount—スクロール バー オブジェクトの ChildCount プロパティは 5 です。 その他のスクロール バーの部分では、ChildCount プロパティは 0 です。
get_accDefaultAction—スクロール バー オブジェクト自体とスクロールサムは、DefaultAction プロパティをサポートしていません。 矢印ボタンの DefaultAction プロパティと、スクロールサムの両側の網掛けされた領域は "Press" です。
get_accDescription—Description プロパティは、クエリを実行するスクロール バーの部分によって異なります。
垂直スクロール バーの各部分には、次の説明があります。
部分 形容 スクロール バー自体 "垂直表示領域の変更に使用" 上矢印ボタン "垂直位置を 1 行上に移動します" 下矢印ボタン "垂直位置を 1 行下に移動します" サムをスクロールする "現在の垂直位置を示し、ドラッグして直接変更できます" ページアップリージョン "垂直位置を 2 行上に移動します" ページダウン領域 "現在の垂直位置を示し、ドラッグして直接変更できます" 水平スクロール バーの各部分には、次の説明があります。
部分 形容 スクロール バー自体 "水平表示領域の変更に使用されます" 左矢印ボタン "水平方向の位置を 1 列左に移動します" 右矢印ボタン '水平方向の位置を 1 列右に移動します" サムをスクロールする "現在の水平位置を示し、ドラッグして直接変更できます" ページの左側の領域 "水平方向の位置を 2 列左に移動します" ページの右側の領域 "現在の垂直位置を示し、ドラッグして直接変更できます" get_accName—Name プロパティは、クエリを実行するスクロール バーの部分によって異なります。
垂直スクロール バーの部分には、次の名前が付けられます。
部分 名前 スクロール バー ウィンドウ "Vertical" 上矢印ボタン "ラインアップ" 下矢印ボタン "下へ行" サムをスクロールする "Position" ページアップリージョン "Page up" ページダウン領域 "Page down" 水平スクロール バーの部分には、次の名前が付けられます。
部分 名前 スクロール バー ウィンドウ "Horizontal" 左矢印ボタン "列の左" 右矢印ボタン "列の右" サムをスクロールする "Position" ページの右側の領域 "ページ右" ページの左側の領域 "ページ左" get_accParent— 矢印ボタン、スクロール サム、およびサムの影付き領域の Parent プロパティは、スクロール バー ウィンドウです。 スクロール バー ウィンドウの Parent プロパティは、コントロールを囲むウィンドウ (ROLE_SYSTEM_WINDOW) であり、Name プロパティとウィンドウ クラス名 同じです。
get_accRole—Role プロパティは、クエリを実行するスクロール バーの部分によって異なります。 スクロール バーの各部分には、次の役割があります。
部分 役割 スクロール バー自体 ROLE_SYSTEM_SCROLLBAR 上、下、左、右方向のボタン ROLE_SYSTEM_PUSHBUTTON サムをスクロールする ROLE_SYSTEM_INDICATOR ページアップ、ページダウン、ページ左、ページ右の領域 ROLE_SYSTEM_PUSHBUTTON get_accState—各スクロール バー コンポーネントの State プロパティには、次の 値の組み合わせが含まれます。
状態 価値 STATE_SYSTEM_INVISIBLE スクロール バー自体の場合、指定した垂直または水平スクロール バーが存在しないことを示します。 ページの上または下の領域の場合、これは、領域が存在しないようにサムが配置されていることを示します。 STATE_SYSTEM_OFFSCREEN スクロール バー自体の場合、指定した垂直または水平スクロール バーが現在表示されないようにウィンドウのサイズが設定されていることを示します。 STATE_SYSTEM_PRESSED 矢印ボタンまたはページ領域が押されています。 STATE_SYSTEM_UNAVAILABLE コンポーネントが無効になっています。 get_accValue—スクロール バー ウィンドウの Value プロパティは、スクロール バーの位置を示し、"0" から "100" までの整数を含む文字列です。
関連トピック
-
IAccessible インターフェイス の