共用方式為


UIElement.OnCreateAutomationPeer 方法

定義

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

protected:
 virtual AutomationPeer ^ OnCreateAutomationPeer() = OnCreateAutomationPeer;
AutomationPeer OnCreateAutomationPeer();
protected virtual AutomationPeer OnCreateAutomationPeer();
function onCreateAutomationPeer()
Protected Overridable Function OnCreateAutomationPeer () As 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 的邏輯,這些邏輯會造成未預期的執行階段行為。

適用於

另請參閱