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 |