IAccPropServices::SetHwndPropServer メソッド (oleacc.h)

このメソッドは SetPropServer をラップし、 HWND ベースのアクセス可能な要素に注釈を付ける呼び出し元に便利なエントリ ポイントを提供します。

構文

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

パラメーター

[in] hwnd

種類: HWND

注釈付けの対象となる、アクセスできる要素を識別します。 これにより、ID 文字列が置き換えられます。

[in] idObject

型: DWORD

注釈付けの対象となる、アクセスできる要素を識別します。 これにより、ID 文字列が置き換えられます。

[in] idChild

型: DWORD

注釈付けの対象となる、アクセスできる要素を識別します。 これにより、ID 文字列が置き換えられます。

[in] paProps

型: const MSAAPROPID*

指定されたコールバック オブジェクトによって処理されるプロパティの配列を指定します。

[in] cProps

型: int

paProps 配列内のプロパティの数を指定します。

[in] pServer

種類: IAccPropServer*

オーバーライドされたプロパティのいずれかがクライアントによって要求されたときに呼び出されるコールバック オブジェクトを指定します。

[in] annoScope

種類: AnnoScope

指定されたアクセスできる要素にのみ注釈が作用する場合は ANNO_THIS を、要素とその直接の子要素に注釈が適用される場合は ANNO_CONTAINER を指定します。

戻り値

型: HRESULT

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

paProps 配列のプロパティのいずれかがサポートされていない場合、ID 文字列が無効な場合、または annoScope がANNO_THISまたはANNO_CONTAINERの 1 つでない場合は、E_INVALIDARGを返します。

メモリ不足などの例外的なエラー状態で他のエラー コードを返す場合があります。

注釈

このメソッドを使用すると、呼び出し元は ID 文字列を取得する必要はありません。 hwnd、 idObject、 idChild の各パラメーターを直接指定できます。

要件

要件	値
サポートされている最小のクライアント	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

こちらもご覧ください

ClearHwndProps

IAccPropServices

SetHwndProp

SetHwndPropStr

SetPropServer