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

こちらもご覧ください

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr