次の方法で共有

スクロール バー (MSAA UI 要素リファレンス)

  • [アーティクル]

注意

このトピックでは、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_accHelp

  • get_accHelpTopic

  • get_accName - Name プロパティは、クエリを実行するスクロール バーの部分によって異なります。

    垂直スクロール バーの部分の名前は次のとおりです。

    パーツ Name
    スクロール バー ウィンドウ "Vertical"
    上矢印ボタン "ラインアップ"
    下矢印ボタン "下へ行"
    サムをスクロールする "Position"
    ページアップ領域 "ページアップ"
    ページダウン領域 "ページダウン"

     

    水平スクロール バーの部分の名前は次のとおりです。

    パーツ 名前
    スクロール バー ウィンドウ "Horizontal"
    左矢印ボタン "列の左"
    右向き矢印ボタン "列の右"
    サムをスクロールする "Position"
    ページの右側の領域 "ページ右"
    ページの左側の領域 "ページ左"

     

  • get_accParent - 矢印ボタン、スクロール サム、サムの両側の網かけ領域の Parent プロパティは、スクロール バー ウィンドウです。 スクロール バー ウィンドウの Parent プロパティは、コントロールを囲み、 同じ Name プロパティとウィンドウ クラス名を持つウィンドウ (ROLE_SYSTEM_WINDOW) です。

  • get_accRole — Role プロパティは、クエリを実行するスクロール バーの部分によって異なります。 スクロール バーの部分には、次の役割があります。

    パーツ ロール
    スクロール バー自体 ROLE_SYSTEM_SCROLLBAR
    上、下、左、右の矢印ボタン ROLE_SYSTEM_PUSHBUTTON
    サムをスクロールする ROLE_SYSTEM_INDICATOR
    ページアップ、ページダウン、ページ左、ページ右の領域 ROLE_SYSTEM_PUSHBUTTON

     

  • get_accState — 各スクロール バー コンポーネントの State プロパティには、次の 値の組み合わせが含まれます。

    State 値
    STATE_SYSTEM_INVISIBLE スクロール バー自体の場合は、指定された垂直または水平方向のスクロール バーが存在しないことを示します。 ページの上または下の領域の場合、これは、領域が存在しないようにサムが配置されていることを示します。
    STATE_SYSTEM_OFFSCREEN スクロール バー自体の場合は、指定した垂直または水平スクロール バーが現在表示されないようにウィンドウのサイズが設定されていることを示します。
    STATE_SYSTEM_PRESSED 矢印ボタンまたはページ領域が押されます。
    STATE_SYSTEM_UNAVAILABLE コンポーネントが無効になっています。

     

  • get_accValue — スクロール バー ウィンドウの Value プロパティは、スクロール バーの位置を示し、"0" から "100" までの整数を含む文字列です。

IAccessible インターフェイス