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());
}
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 的任何逻辑可能会产生意外的运行时行为。