IAccPropServices::ClearHwndProps メソッド (oleacc.h)
このメソッドは 、SetPropValue、 SetPropServer、 ClearProps をラップし、 HWND ベースのアクセス可能な要素に注釈を付ける呼び出し元に便利なエントリ ポイントを提供します。
構文
HRESULT ClearHwndProps(
[in] HWND hwnd,
[in] DWORD idObject,
[in] DWORD idChild,
[in] const MSAAPROPID *paProps,
[in] int cProps
);
パラメーター
[in] hwnd
種類: HWND
注釈付けの対象となる、アクセスできる要素を識別します。 これにより、ID 文字列が置き換えられます。
[in] idObject
種類: DWORD
注釈付けの対象となる、アクセスできる要素を識別します。 これにより、ID 文字列が置き換えられます。
[in] idChild
種類: DWORD
注釈付けの対象となる、アクセスできる要素を識別します。 これにより、ID 文字列が置き換えられます。
[in] paProps
型: const MSAAPROPID*
リセットされるプロパティの配列を指定します。 これらのプロパティは、注釈が付けられる前の既定の動作に戻ります。
[in] cProps
型: int
paProps 配列内のプロパティの数を指定します。
戻り値
種類: HRESULT
成功した場合、 は、指定されたプロパティにアクセス可能なオブジェクトに注釈が付けたことがない場合でも、S_OKを返します。既にクリアされているプロパティのクリアは成功と見なされます。
paProps 配列のプロパティのいずれかがサポートされていない場合は、E_INVALIDARGを返します。
メモリ不足などの例外的なエラー条件下で、他のエラー コードが返される場合があります。
戻り値の説明については、対応する SetPropValue、 SetPropServer、または ClearProps メソッドを 参照してください。
注釈
このメソッドを使用すると、呼び出し元は ID 文字列を取得する必要はありません。 hwnd、 idObject、 idChild の各パラメーターを直接指定できます。
さらに、 SetHwndPropStr は通常の Unicode 文字列をパラメーターとして受け取ります。呼び出し元は 、BSTR を特別に割り当てる必要はありません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | oleacc.h (最初に OleAcc.h Initguid.h を含める) |
| [DLL] | Oleacc.dll |
| 再頒布可能パッケージ | SP6 以降および Windows 98 を使用した Windows NT 4.0 の Active Accessibility 2.0 RDK |