IAccPropServer::GetPropValue メソッド (oleacc.h)

アクセス可能な要素のプロパティ値を取得します。

構文

HRESULT GetPropValue(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [in]  MSAAPROPID idProp,
  [out] VARIANT    *pvarValue,
  [out] BOOL       *pfHasProp
);

パラメーター

[in] pIDString

型: const BYTE*

要求されているプロパティを識別する文字列を格納します。

[in] dwIDStringLen

型: DWORD

pIDString パラメーターによって指定される ID 文字列の長さを指定します。

[in] idProp

種類: MSAAPROPID

目的のプロパティを示す GUID を指定します。

[out] pvarValue

型: VARIANT*

オーバーライドされたプロパティの値を指定します。 このパラメーターは、 pfHasProp が TRUE の場合にのみ有効です。 pfHasProp が FALSE に設定されている場合、サーバーはこれをVT_EMPTYに設定する必要があります。

[out] pfHasProp

種類: BOOL*

要求されたプロパティの値をサーバーが提供しているかどうかを示します。 サーバーは、オーバーライドするプロパティを返す場合は TRUE 、プロパティを返さない場合は FALSE に設定する必要があります (その場合は pvarValue も VT_EMPTY に設定する必要があります)。

戻り値

型: HRESULT

メモリ不足などの例外的なエラー条件下を除き、S_OKを返します。 指定したプロパティがオーバーライドされない場合は、 pfHasProp を FALSE に設定し、 pvarValue をサーバーによってVT_EMPTYに設定する必要があります。

注釈

複数のアクセス可能な要素に注釈を付けるために 1 つのコールバック オブジェクトが登録されている場合、ID 文字列を使用して、この要求が参照する要素を特定できます。

アクセス可能な要素が HWND ベースの場合、 IAccPropServices::D ecomposeHwndIdentityString を使用して、ID 文字列から HWND/idObject/idChild を抽出できます。

指定したプロパティに対して返す値がコールバックに含まれている場合は、 それを pvarValue で返し、 pfHasProp を TRUE に設定する必要があります。 それ以外の場合は 、pvarValue を VT_EMPTY に設定し、 pfHasProp を FALSE に設定する必要があります。 この後者の場合、元の IAccessible インターフェイス ポインターを使用して、このプロパティの値を取得します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista または Windows XP
サポートされている最小のサーバー	Windows Server 2003
対象プラットフォーム	Windows
ヘッダー	oleacc.h (最初に OleAcc.h を含める Initguid.h を含めます。
[DLL]	Oleacc.dll
再頒布可能パッケージ	SP6 以降および Windows 98 を使用した Windows NT 4.0 のアクティブなアクセシビリティ 2.0 RDK