UIElement.OnCreateAutomationPeer 方法

定義

命名空間:

Microsoft.UI.Xaml

在衍生類別中實作時，會傳回 Microsoft UI 自動化基礎結構的類別特定 AutomationPeer 實作。

protected:
 virtual AutomationPeer ^ OnCreateAutomationPeer() = OnCreateAutomationPeer;

AutomationPeer OnCreateAutomationPeer();

protected virtual AutomationPeer OnCreateAutomationPeer();

function onCreateAutomationPeer()

Protected Overridable Function OnCreateAutomationPeer () As AutomationPeer

傳回

AutomationPeer

要傳回的類別特定 AutomationPeer 子類別。

範例

整個實作 OnCreateAutomationPeer 應該包含建構自訂自動化對等類別並傳回它。

protected override AutomationPeer OnCreateAutomationPeer() 
{
    return new MediaContainerAP(this, mediaElement); 
}

#include "MediaContainerAP.h"
...
public:
    MyNamespace::MediaContainerAP OnCreateAutomationPeer()
    {
        return winrt::make<MyNamespace::implementation::MediaContainerAP>(*this, mediaElement());
    }

備註

如需自動化對等用途的詳細資訊，以及您可能需要定義類別特定 AutomationPeer 類別的原因，請參閱 自訂自動化對等。

您應該在想要為 Microsoft UI 自動化提供自訂自動化對等的自訂類別中覆寫這個方法，而不是預設實作所參考的預設 OnCreateAutomationPeer 對等。 您為自訂控制項定義自訂對等的方式取決於控制項的協助工具需求、其 UI 合約及其行為。 如需如何定義新對等的詳細資訊，請參閱 自訂自動化對等。

注意

此範例不會維護，而且可能不會進行編譯。

如需 的實作，請參閱 XAML 協助工具範例 ，以定義 (對等實 OnCreateAutomationPeer 作所 OnCreateAutomationPeer 傳回的自訂對等，在此範例中為案例 3 的一部分) 。

我們建議實作 OnCreateAutomationPeer 應該不只初始化自訂自動化對等的新實例、傳遞呼叫控制項做為擁有者，並傳回該實例。 請勿在這個方法中嘗試執行其他邏輯。 特別是任何可能會破壞同一個呼叫內的 AutomationPeer 的邏輯，這些邏輯會造成未預期的執行階段行為。

另請參閱

• AutomationPeer
• 解決 Windows 傳統型應用程式中常見程式設計協助工具問題的程式碼範例
• 自訂自動化對等
• 協助工具