样式控件模式

介绍实现 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 自动化树概述