IAccessible::get_accDescription メソッド (oleacc.h)
IAccessible::get_accDescription メソッドは、指定したオブジェクトの視覚的な外観を表す文字列を取得します。 説明が用意されていないオブジェクトもあります。
構文
HRESULT get_accDescription(
[in] VARIANT varChild,
[out, retval] BSTR *pszDescription
);
パラメーター
[in] varChild
型: VARIANT
取得した説明がオブジェクトに属するか、オブジェクトの子要素のいずれかに属するかを指定します。 このパラメーターは、CHILDID_SELF (オブジェクトに関する情報を取得する場合) または子 ID (オブジェクトの子要素に関する情報を取得する場合) のいずれかです。 VARIANT 構造体の初期化の詳細については、「子 ID をパラメーターで使用する方法」を参照してください。
[out, retval] pszDescription
種類: BSTR*
指定したオブジェクトを記述するローカライズされた文字列を受け取る BSTR のアドレス。このオブジェクトに説明がない場合は NULL 。
戻り値
種類: HRESULT
成功した場合は、S_OK を返します。
成功しなかった場合は、次のテーブルの値の 1 つ、または別の標準 COM エラー コードを返します。 サーバーはこれらの値を返しますが、クライアントは常に出力パラメーターをチェックして、有効な値が含まれていることを確認する必要があります。 詳細については、「 IAccessible 戻り値の確認」を参照してください。
| リターン コード | 説明 |
|---|---|
|
指定されたオブジェクトには説明がありません。 |
|
引数が有効ではありません。 |
|
指定したオブジェクトは、このプロパティをサポートしていません。 |
注釈
Microsoft Active Accessibility サーバーでは、直接注釈を使用するか、IAccessibleEx インターフェイスを使用するか、Microsoft Active Accessibility を実装し、WM_GETOBJECT メッセージを処理する両方の実装と並べてUI オートメーションすることで、UI オートメーションのサポートを追加できます。
このプロパティは、ユーザーの オブジェクトに相当するテキストを提供します。 説明は、HTML の Alt 属性で指定されたテキストに似ている必要があります。これは、テキストのみのブラウザーを使用しているユーザーの画像を記述するために表示されるテキストです。 ただし、一部のコントロールでは、このプロパティを使用して、テキストに相当するコントロールに関連しないコントロールに関する追加情報を格納します。 このプロパティの詳細については、「 Description プロパティ」を参照してください。
サーバー開発者への注意: このプロパティから返される文字列をローカライズします。
サーバーの例
次のコード例は、独自の子要素を保持するカスタム リスト ボックスに対して、このメソッドの 1 つの実装が可能であることを示しています。 この例では 構文を示していますが、実際のテキストのみのリスト ボックスでは、このプロパティをサポートする必要はないでしょう。 わかりやすくするために、この例の文字列はローカライズされません。
HRESULT STDMETHODCALLTYPE AccServer::get_accDescription(
VARIANT varChild,
BSTR *pszDescription)
{
if (varChild.vt != VT_I4)
{
*pszDescription = NULL;
return E_INVALIDARG;
}
if (varChild.lVal == CHILDID_SELF)
{
*pszDescription = SysAllocString(L"List of contacts.");
}
else
{
*pszDescription = SysAllocString(L"A contact.");
}
return S_OK;
};
クライアントの例
次の関数例では、指定したアクセシビリティ対応オブジェクトまたは子要素の説明を取得し、コンソールに表示します。
HRESULT PrintDescription(IAccessible* pAcc, long child)
{
VARIANT varObject;
varObject.vt = VT_I4;
varObject.lVal = child;
BSTR bstrDesc;
HRESULT hr = pAcc->get_accDescription(varObject, &bstrDesc);
if (hr == S_OK)
{
printf("Description: %S\n", bstrDesc);
SysFreeString(bstrDesc);
}
return hr;
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | oleacc.h |
| Library | Oleacc.lib |
| [DLL] | Oleacc.dll |
| 再頒布可能パッケージ | SP6 以降および Windows 95 を使用した Windows NT 4.0 の Active Accessibility 1.3 RDK |
関連項目
概念
リファレンス
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示