共用方式為


IAccPropServices::ClearHwndProps 方法 (oleacc.h)

這個方法會包裝 SetPropValueSetPropServerClearProps,併為標註 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。

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

如需傳回值的描述,請參閱對應的 SetPropValueSetPropServerClearProps 方法。

備註

藉由使用此方法,呼叫端不需要取得識別字串;它可以直接指定 hwndidObjectidChild 參數。

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

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 oleacc.h (include OleAcc.h Include Initguid.h first.)
Dll Oleacc.dll
可轉散發套件 Windows NT 4.0 上的 Active Accessibility 2.0 RDK 搭配 SP6 和更新版本和 Windows 98

另請參閱

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr