Тип элемента управления SemanticZoom
В этом разделе содержатся сведения о поддержке автоматизации пользовательского интерфейса для типа элемента управления SemanticZoom.
Семантический масштаб — это метод, представленный в Windows 8 для представления и навигации по большим наборам связанных данных или содержимого в одном представлении, например фотоальбом, списком приложений или адресной книгой. Семантический масштаб использует два разных режима классификации или уровней масштабированиядля организации и представления содержимого. Низкоуровневый (или увеличенный в режиме) отображает элементы в плоской структуре "все вверх"; и режим высокого уровня (или увеличенного масштаба) отображает элементы в группах, что позволяет пользователю быстро перемещаться и просматривать содержимое. Например, увеличение списка городов может измениться на список штатов, содержащих эти города. Масштабирование списка программ может измениться на список групп логических программ.
Дополнительные сведения о семантическом масштабировании, специально используемом для приложений Магазина Windows, см. в руководствах по семантике масштабирования.
Модель использования для типа элемента управления SemanticZoom является необычной в том, что она существует главным образом для программного доступа. Клиенты службы автоматизации пользовательского интерфейса Майкрософт могут отслеживать и управлять элементом управления "Семантический масштаб", чтобы управлять состоянием списка с увеличением масштаба. Пользователи, которые не используют вспомогательные технологии, обычно управляют элементом управления семантического масштабирования непосредственно с помощью жестов сенсорного ввода или сочетаний клавиш.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления SemanticZoom. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления семантического масштабирования, в которых платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- необходимые шаблоны элементов управления и свойства
- обязательные события
- примечания
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к типу элемента управления SemanticZoom, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Или:
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значения или определения которых особенно важны для элементов управления, реализующих тип элемента управления SemanticZoom. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
| Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. заметки. | Если элемент управления списком имеет указатель мыши (точка, которую можно щелкнуть, чтобы привести к фокусу списка), эта точка должна быть предоставлена с помощью этого свойства. Если значение свойства UIA_IsOffscreenPropertyId равно TRUE, попытка получить это свойство приводит к ошибке UIA_E_NOCLICKABLEPOINT. |
| UIA_ControlTypePropertyId | SemanticZoom | |
| UIA_IsContentElementPropertyId | ИСТИННЫЙ | |
| UIA_IsControlElementPropertyId | ИСТИННЫЙ | |
| UIA_IsKeyboardFocusablePropertyId | ЛОЖНЫЙ | |
| UIA_LabeledByPropertyId | См. заметки. | Если имеется статическое текстовое метка, это свойство должно предоставлять ссылку на этот элемент управления. |
| UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления SemanticZoom. Значение по умолчанию — "семантический масштаб" для en-US или английского языка (США).
Примечание. некоторые платформы объединяли эту платформу как "semanticzoom". |
| UIA_NamePropertyId | См. заметки. | Пустая строка допустима или может быть предоставлено более полезное имя, если оно не содержит термин семантического масштабирования, что приведет к путанице в сочетании типа элемента управления и имени. |
Обязательные шаблоны элементов управления и свойства
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления семантического масштабирования. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
| Управление шаблоном или свойством шаблонов | Поддержка и значение | Примечания |
|---|---|---|
| IToggleProvider | Зависит | Элементы управления семантического масштабирования поддерживают шаблон переключателя, чтобы можно было включить или отключить масштаб. ToggleState_Off соответствует плоскому, всем состоянию и ToggleState_On соответствует высокому уровню, масштабированному представлению. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления семантического масштабирования. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| событие UIA_BoundingRectanglePropertyId изменено свойством. | |
| событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
| событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
| UIA_ToggleToggleStatePropertyId событие, измененное свойством. |
Замечания
Если в пользовательском интерфейсе есть видимая кнопка для переключения поведения элемента управления семантического масштабирования, эта кнопка не должна иметь тип элемента управления SemanticZoom. Это не интуитивно понятно, но тип элемента управления SemanticZoom характеризует контейнер содержимого масштабирования, а не кнопку, которая управляет масштабом. (Такая кнопка может быть представлена просто как тип элемента управления Button с помощью шаблона элемента управления переключателя.)