样式控件模式

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

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

本主题包含以下各节:

实现准则和约定

实现样式控件模式 ,请注意以下准则和约定:

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

IStylesProvider 的必需成员

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

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

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

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

UI 自动化控件模式概述

UI 自动化树概述