UIElement.OnCreateAutomationPeer 方法

定義

命名空間:

Windows.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());
    }

protected:
    virtual AutomationPeer^ OnCreateAutomationPeer() override
    {
        return ref new MediaContainerAP(this, mediaElement);
    }
};

Protected Overrides Function OnCreateAutomationPeer() As AutomationPeer
    Return New MediaContainerAP(Me, mediaElement)
End Function

備註

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

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

注意

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

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

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

另請參閱

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