AutomationPeer.GetPatternCore(PatternInterface) 方法

  • 参考

定义

命名空间:
Microsoft.UI.Xaml.Automation.Peers
编辑

在 Microsoft UI 自动化客户端调用 GetPattern 或等效的 Microsoft UI 自动化客户端 API 时提供对等行为。

protected:
 virtual Platform::Object ^ GetPatternCore(PatternInterface patternInterface) = GetPatternCore;
IInspectable GetPatternCore(PatternInterface const& patternInterface);
protected virtual object GetPatternCore(PatternInterface patternInterface);
function getPatternCore(patternInterface)
Protected Overridable Function GetPatternCore (patternInterface As PatternInterface) As Object

参数

patternInterface
PatternInterface

PatternInterface 枚举中的值。

返回

Object

Platform::Object

IInspectable

实现模式接口的 对象;如果对等不支持此接口，则为 null 。

注解

AutomationPeer 级别的标准实现返回 null，因为基本对等类不支持任何模式。 大多数现有Windows 运行时对等类都替代此方法，以报告特定对等支持的模式。

重写此方法以返回对等类支持的模式的实现是实现自动化对等的最常见方案之一。 请参阅自定义自动化对等。

请参阅 XAML 辅助功能示例 (请注意，此示例未维护，可能无法编译 用于定义 OnCreateAutomationPeer 返回的自定义对等互连的 OnCreateAutomationPeer 实现) ， (可以在示例) 的方案 3 中找到对等实现。

Windows 8 行为

Windows 8控件是否打算将数据显示为项而可能影响对等选择行为。 Windows 8的自动化逻辑可能会选择专用数据对等方并使用其模式，即使为整体控件指示了一个对等，并且该对等会替代 GetPatternCore。 例如，你可能具有模式的 ListViewAutomationPeer 替代，但在Windows 8数据项的行为模式可能优先，例如，可以使用 ListViewItemDataAutomationPeer 的默认实现，并在UI 自动化查找项中的模式时处理滚动模式。 从Windows 8.1开始，情况就不同了;如果 GetPatternCore 实现中指示了整体控件的模式支持，则使用该实现而不是内部项数据对等方。

如果将应用代码从Windows 8迁移到Windows 8.1可能需要考虑此行为更改，因为这意味着项目控件模式支持也可能用于数据项，并且可能需要添加项滚动行为等。

对于针对 Windows 8 编译的应用，如果它在 Windows 8.1 上运行，将继续使用 Windows 8 行为。

适用于

另请参阅