样式控件模式

介绍实现 IStylesProvider 的准则和约定，包括有关属性和方法的信息。 Styles 控件图案用于描述具有特定样式、填充颜色、填充图案或形状的 UI 元素。

Styles 控件模式对于描述文档中经常具有此类样式的元素特别有用。 样式通常包含对残障客户有用的信息;例如，样式可以将某个字符串描述为文档的标题，或将某个流程图对象描述为菱形或圆形。 有关实现此控件模式的控件示例，请参阅 控件类型及其支持的控件模式。

本主题包含以下各节：

• 实现准则和约定
• IStylesProvider 的必需成员
• 相关主题

实现准则和约定

实现 Styles 控件模式时，请注意以下准则和约定：

• UIAutomationClient.h 头文件定义了一组用于标识多种常见样式的命名常量值。 有关详细信息，请参阅 样式标识符。
• 如果使用 StyleId_Custom，则必须实现 IStylesProvider：：StyleName 属性，使客户端能够发现样式的名称。 不需要为标准样式实现 StyleName 属性，因为 Microsoft UI 自动化 提供默认名称，但如果需要替代默认名称，则可以实现它。
• 样式模式中的其他属性是可选的;提供程序可以为不支持的属性返回UIA_E_NOTSUPPORTED。
• 文本区域中的样式可通过以下文本属性表示：
  • 响应 对 StyleId 文本属性的请求时，文本范围应返回样式标识符中所述的样式 标识符之一。
  • 如果使用 StyleId_Custom ，则文本范围应返回 StyleName 文本属性的字符串值，以使客户端能够发现样式名称。
  • 具有多个样式（如标题和普通文本）的文本区域应返回 StyleId 和 StyleName 属性的特殊UI 自动化 ReservedMixedAttributeValue 属性。 接收此响应的客户端可以细分文本范围，以查找样式的开始和结束位置。
• 应用程序可以使用各种样式来描述对象，但UI 自动化仅表示最常见的样式。 若要表示其他样式属性（如边框颜色），提供程序可以在 ExtendedProperties 属性中返回其他属性的列表。 这基本上是一个属性包，其中包含一组扩展属性，例如“BorderColor=0xFF0000;BorderStyle=dotted”。 扩展属性的值可以特定于应用程序。

IStylesProvider 的必需成员

实现 IStylesProvider 接口需要以下属性。

必需的成员	成员类型	说明
ExtendedProperties	属性	无
FillColor	属性	无
FillPatternColor	属性	无
FillPatternStyle	属性	无
形状	属性	无
StyleId	属性	无
StyleName	属性	无

 

没有与此控件模式关联的方法或事件。

相关主题

控件类型及其支持的控件模式

UI 自动化控件模式概述

UI 自动化树概述