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

  • Статья

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

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

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

Правила и соглашения реализации

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

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

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

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

Обязательные члены Тип члена Примечания
ExtendedProperties Свойство Нет
Fillcolor Свойство Нет
FillPatternColor Свойство Нет
FillPatternStyle Свойство Нет
Формы Свойство Нет
Styleid Свойство Нет
ИмяСтиля Свойство Нет

 

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

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

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

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