Description プロパティ (Windows アクセシビリティ機能)

  • [アーティクル]

注意

Description プロパティは誤って使用されることが多く、Microsoft UI オートメーションではサポートされていません。 Microsoft Active Accessibility サーバー開発者は、このプロパティを使用しないでください。 アクセシビリティと自動化のシナリオに関する詳細情報が必要な場合は、UI オートメーション要素とコントロール パターンでサポートされているプロパティを使用します。

 

オブジェクトの Description プロパティは、オブジェクトの外観に関するテキストによる説明を提供します。 説明は主に、視覚障または盲目のユーザーに大きなコンテキストを提供するために使用されますが、コンテキスト検索やその他のアプリケーションにも使用されます。 このプロパティは、ユーザーがアイコンまたは全体的な外観を理解するのに役立ちます。

Description プロパティは、IAccessible::get_accDescription を呼び出すことによって取得されます。

Description プロパティをサポートするタイミング

説明が明確でない場合、またはオブジェクトの Name、Role、State、および Value プロパティに基づいて冗長でない場合、サーバーは Description プロパティをサポートします。 たとえば、"OK" というラベルの付いたボタンには追加情報は必要ありませんが、サボテンの画像を示すボタンは必要です。 このようなボタンの Name、 Role、 Help プロパティは目的を説明しますが、 Description プロパティは、あまり具体的ではない情報を伝えます。たとえば、"このボタンはサボテンの画像を表示します。

Microsoft Active Accessibility サーバーは、直接注釈を使用するか、IAccessibleEx インターフェイスを使用するか、Microsoft Active Accessibility を実装し、WM_GETOBJECT メッセージを処理する両方の実装と並べてUI オートメーションすることで、UI オートメーションのサポートを追加できます。

直接注釈の使用

IAccessibleEx インターフェイス