样式控件模式
介绍实现 IStylesProvider的准则和约定,包括有关属性和方法的信息。 样式 控件模式用于描述具有特定样式、填充颜色、填充图案或形状的 UI 元素。
样式 控件模式对于描述文档中经常具有此类样式的元素特别有用。 样式通常携带对残障客户有用的信息;例如,样式可以将特定字符串描述为文档的标题,或者将特定流程图对象描述为菱形或圆圈。 有关实现此控件模式的控件示例,请参阅 控件类型及其支持的控件模式。
本主题包含以下部分。
实施准则和约定
实现 样式 控件模式时,请注意以下准则和约定:
- 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 | 财产 | 没有 |
此控件模式没有关联的方法或事件。
相关主题