UIElement.OnCreateAutomationPeer 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在衍生類別中實作時，會傳回 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 的邏輯，這些邏輯會造成未預期的執行階段行為。