共用方式為

IRawElementProviderHwndOverride：：GetOverrideProviderForHwnd 方法 (uiautomationcore.h)

  • 發行項

取得指定專案的 使用者介面自動化 提供者。

語法

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

參數

[in] hwnd

類型： HWND

項目的視窗控制代碼。

[out, retval] pRetVal

類型： IRawElementProviderSimple**

接收指定之視窗之新提供者的指標，如果未覆寫提供者，則為 NULL 。 這個參數會以未初始化的狀態傳遞。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法是由包含視窗型子專案的片段根實作。 根據預設，除了任何自定義提供者之外，Windows 中裝載的控件也會由預設提供者提供服務。 預設提供者會將父視窗內的所有視窗視為同層級。 如果您想要重新建構 使用者介面自動化 樹狀結構，讓某個視窗型控件視為另一個視窗型控件的子系，您必須在片段根目錄上實作此方法來覆寫預設提供者。 傳回的提供者可以提供其他屬性或覆寫指定元件的屬性。

傳回的提供者必須是片段樹狀結構的一部分。 它可以提供其他屬性或覆寫指定元件的屬性。

如果傳回的提供者實作 IRawElementProviderFragment，提供者應該是片段樹狀結構的一部分，而且可以透過從片段的根目錄巡覽來連線。

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

IRawElementProviderHwndOverride