次の方法で共有

動的注釈の種類

  • [アーティクル]

Microsoft Active Accessibility でサポートされている動的注釈には、 直接注釈、 値マップ注釈、 サーバー注釈の 3 種類があります。 各型には固有の利点があるため、違いを理解することが重要です。

直接注釈

直接注釈は、動的注釈の最も簡単な形式です。 これは、注釈付きプロパティがコントロールの状態に依存せず、値マップ注釈とサーバー注釈によって提供される追加のサポートを必要としない、アクセス可能な要素に最も適しています。 直接注釈は、アクセス可能な要素の 1 つ以上の Microsoft Active Accessibility プロパティの値をオーバーライドしたり、コントロールに Microsoft UI オートメーション プロパティをオーバーライドまたは追加したりするために使用されます。 Microsoft Active Accessibility プロパティで行われた注釈はすべて、UI オートメーション翻訳と Microsoft Active Accessibility から UI オートメーション プロキシに反映されます。 詳細については、「 直接注釈」を参照してください。

値マップの注釈

IAccessible プロパティに直接注釈を付けるだけでなく、多くの場合、コントロール固有の値を、エンド ユーザーが理解できる文字列に変換する必要があります。 たとえば、[表示プロパティ] ウィンドウの [設定] タブにある画面解像度スライダー コントロール (コントロール パネル)。 各スライダーの位置は異なる解像度 (640 x 480、1024 x 768 など) に対応していますが、コントロールにはこの関係に関する知識がなく、この情報を Microsoft Active Accessibility に伝達することはできません。

値マップ注釈を使用すると、このタスクが簡単になります。 この形式の注釈を使用すると、スライダー値の文字列を指定し、リスト ビューとツリー ビューのアイコンのロール、状態、および説明を指定できます。 詳細については、「 値マップの注釈」を参照してください。

サーバー注釈

サーバー注釈を使用すると、開発者はコールバック オブジェクトを、要素の注釈付きプロパティに対するクライアント要求にサービスを登録できます。 このコールバック オブジェクトは 、IAccPropServer インターフェイスを実装し、Microsoft Active Accessibility 注釈サービスに登録する必要があります。 登録されると、そのアクセス可能な要素のプロパティ値に対するすべてのクライアント要求にサービスを提供するように求められます。

サーバー注釈の特に便利な機能の 1 つは、コンテナーとそのすべての子に対する要求を処理するためにサーバーを 1 回登録できることです。 そのため、たとえば、1 つのサーバーを 1 回設定して、すべてのアイテムの要求を処理できます。これはリスト ボックスです。 詳細については、「 サーバー注釈」を参照してください。