Поделиться через

Шаблон элемента управления "Стили"

  • Статья

Описание рекомендаций и соглашений по реализации IStylesProvider, включая сведения о свойствах и методах. Шаблон элемента управления стилей используется для описания элемента пользовательского интерфейса с определенным стилем, цветом заливки, шаблоном заливки или фигурой.

Шаблон элемента управления стилей особенно полезен для описания элементов в документе, которые часто имеют такие стили. Стили обычно несут информацию, полезную для клиентов с ограниченными возможностями; Например, стиль может описать определенную строку как название документа или определенный блок-схема как алмаз или круг. Примеры элементов управления, реализующих этот шаблон элемента управления, см. в типах элементов управления и их поддерживаемых шаблонах элементов управления.

В этом разделе содержатся следующие разделы.

Рекомендации по реализации и соглашения

При реализации шаблона элемента управления стилей обратите внимание на следующие рекомендации и соглашения:

  • Файл заголовка UIAutomationClient.h определяет набор именованных значений констант, используемых для определения нескольких распространенных стилей. Дополнительные сведения см. в разделе Идентификаторы стилей.
  • При использовании StyleId_Customнеобходимо реализовать свойство IStylesProvider::StyleName, чтобы клиенты могли обнаруживать имя стиля. Не нужно реализовать свойство StyleName для стандартного стиля, так как служба автоматизации пользовательского интерфейса Майкрософт предоставляет имя по умолчанию, но его можно реализовать, если необходимо переопределить имя по умолчанию.
  • Другие свойства в шаблоне стилей являются необязательными; Поставщик может возвращать UIA_E_NOTSUPPORTED для свойства, которое не поддерживается.
  • Стили в текстовом диапазоне можно представить с помощью следующих текстовых атрибутов:
    • При реагировании на запрос атрибута StyleId текстовый диапазон должен возвращать один из идентификаторов стиля, описанных в идентификаторов стилей.
    • Если используется StyleId_Custom, текстовый диапазон должен возвращать строковое значение для атрибута styleName styleName, чтобы клиенты могли обнаруживать имя стиля.
    • Диапазон текста с несколькими стилями, такими как заголовок и обычный текст, должен возвращать специальное свойство автоматизации пользовательского интерфейса ReservedMixedAttributeValue для свойств styleId и StyleName. Клиент, получающий этот ответ, может разделить текстовый диапазон, чтобы найти, где начинаются и заканчиваются стили.
  • Приложения могут использовать широкий спектр стилей для описания объектов, но автоматизация пользовательского интерфейса представляет только наиболее распространенные. Для представления дополнительных атрибутов стиля, таких как цвет границы, поставщик может вернуть список дополнительных атрибутов в свойстве ExtendedProperties. Это в основном контейнер свойств с набором расширенных свойств, например "BorderColor=0xFF0000; BorderStyle=dotted. Значения расширенных свойств могут быть конкретными приложениями.

Обязательные элементы для IStylesProvider

Следующие свойства необходимы для реализации интерфейса IStylesProvider.

Обязательные элементы Тип элемента Примечания
ExtendedProperties Свойство Никакой
FillColor Свойство Никакой
FillPatternColor Свойство Никакой
FillPatternStyle Свойство Никакой
фигуры Свойство Никакой
StyleId Свойство Никакой
StyleName Свойство Никакой

 

Этот шаблон элемента управления не имеет связанных методов или событий.

Типы элементов управления и поддерживаемые шаблоны элементов управления

Обзор шаблонов элементов управления автоматизации пользовательского интерфейса

Обзор дерева автоматизации пользовательского интерфейса