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

識別要標註的可存取項目。 這會取代識別字串。

[in] idObject

類型： DWORD

識別要標註的可存取項目。 這會取代識別字串。

[in] idChild

類型： DWORD

識別要標註的可存取項目。 這會取代識別字串。

[in] paProps

類型： const MSAAPROPID*

指定要重設之屬性的陣列。 這些屬性會還原為在經過標註之前所顯示的預設行為。

[in] cProps

類型： int

指定 paProps 陣列中的屬性數目。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，即使指定的屬性從未在可存取的物件上加上批注也一樣;清除已清除的屬性會被視為成功。

如果 不支援 paProps 陣列中的任何屬性，則傳回E_INVALIDARG。

可能會在例外狀況下傳回其他錯誤碼，例如記憶體不足。

如需傳回值的描述，請參閱對應的 SetPropValue、 SetPropServer 或 ClearProps 方法。

備註

藉由使用此方法，呼叫端不需要取得識別字串;它可以直接指定 hwnd、 idObject 和 idChild 參數。

此外， SetHwndPropStr 會採用一般 Unicode 字串做為參數;呼叫端不需要特別配置 BSTR。

規格需求

另請參閱

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr