IAccessible::get_accValue メソッド (oleacc.h)

IAccessible::get_accValue メソッドは、指定したオブジェクトの値を取得します。 値のないオブジェクトもあります。

構文

HRESULT get_accValue(
  [in]          VARIANT varChild,
  [out, retval] BSTR    *pszValue
);

パラメーター

[in] varChild

型: VARIANT

取得した値情報がオブジェクトに属するか、オブジェクトの子要素の 1 つに属するかを指定します。 このパラメーターは、CHILDID_SELF (オブジェクトに関する情報を取得するため) または子 ID (オブジェクトの子要素に関する情報を取得する場合) のいずれかです。 VARIANT 構造体の初期化の詳細については、「パラメーターでの子 ID の使用方法」を参照してください。

[out, retval] pszValue

種類: BSTR*

オブジェクトの現在の値を含むローカライズされた文字列を受け取る BSTR のアドレス。

戻り値

型: HRESULT

成功した場合は、S_OK を返します。

成功しなかった場合は、次のテーブルの値の 1 つ、または別の標準 COM エラー コードを返します。 サーバーはこれらの値を返しますが、クライアントは常に出力パラメーターをチェックして、有効な値が含まれていることを確認する必要があります。 詳細については、「 IAccessible 戻り値の確認」を参照してください。

エラー 説明
DISP_E_MEMBERNOTFOUND
オブジェクトは、このプロパティをサポートしていません。
E_INVALIDARG
引数が有効ではありません。

注釈

スクロール バーとトラックバーのアクセシビリティ対応オブジェクトから返される数値は、パーセンテージを示します。 これらは、0 (0) から 100 (100) までの整数ですが、1 (1) から 16 (16) までの範囲が限られている場合もあります。 また、一部のスクロール バーオブジェクトとトラックバーオブジェクトは、画面サイズやインターネットセキュリティなどの設定に対応する文字列を返します。

サーバー開発者への注意: このプロパティから返される文字列をローカライズします。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー oleacc.h
Library Oleacc.lib
[DLL] Oleacc.dll
再頒布可能パッケージ SP6 以降および Windows 95 を使用した Windows NT 4.0 のアクティブなアクセシビリティ 1.3 RDK

こちらもご覧ください

Iaccessible

Value プロパティ