UiaProviderForNonClient 函式 (uiautomationcoreapi.h)

取得窗口整個非工作區的提供者，或是視窗非工作區中的控件。

語法

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

參數

[in] hwnd

類型： HWND

擁有非工作區或非用戶端控制件的視窗。

[in] idObject

類型： long

非用戶端控制件的物件標識碼 ，或整個 非工作區OBJID_WINDOW。 如需可能值的清單，請參閱 對象標識碼。

[in] idChild

類型： long

非用戶端控制件的子標識碼。

[out] ppProvider

類型： IRawElementProviderSimple**

接收非工作區或非用戶端控制件的提供者。

傳回值

類型： HRESULT

如果成功或錯誤值，則傳回S_OK。

備註

此函式會傳回視窗非工作區的預設 Microsoft 使用者介面自動化 提供者。 使用者介面自動化 支援非工作區，而不需要視窗的任何明確說明。 您可以使用此函式所擷取的 IRawElementProviderSimple 介面來覆寫和自定義支援。

當您搭配 ProviderOptions_RefuseNonClientSupport 旗標使用它時，此函式特別有用，這會停用非工作區的預設提供者 使用者介面自動化，讓視窗可以提供自己的提供者。

非工作區中控件的支持對象標識碼包括OBJID_WINDOW、OBJID_VSCROLL、OBJID_HSCROLL、OBJID_TITLEBAR、OBJID_MENU和OBJID_SIZEGRIP。 針對 OBJID_TITLEBAR，請使用子標識符來區別整個標題列及其包含的按鈕。

規格需求

另請參閱

提供者的函式