Тип элемента управления 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 | TRUE | |
| UIA_IsControlElementPropertyId | TRUE | |
| UIA_IsKeyboardFocusablePropertyId | Ложь. | |
| UIA_LabeledByPropertyId | См. примечания. | При наличии статической текстовой метки это свойство должно предоставлять ссылку на этот элемент управления. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления SemanticZoom . Значение по умолчанию — "семантический масштаб" для en-US или english (США). Примечание: Некоторые платформы сцепляли его как "semanticzoom". |
| UIA_NamePropertyId | См. примечания. | Пустая строка является приемлемой или может быть предоставлено более полезное имя, если она не содержит термин семантического масштабирования, что приведет к путанице сочетания типа элемента управления и имени. |
Обязательные шаблоны и свойства элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления семантического масштабирования. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания |
|---|---|---|
| IToggleProvider | Зависит | Элементы управления семантического масштабирования поддерживают шаблон элемента управления "Переключение ", чтобы включить или отключить масштаб. ToggleState_Off соответствует плоскому, полному состоянию, а ToggleState_On соответствует высокому масштабированному представлению. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, которые необходимы для поддержки элементов управления семантического масштабирования. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_BoundingRectanglePropertyId событие изменения свойства. | |
| UIA_IsEnabledPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие. |
| UIA_IsOffscreenPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие. |
| UIA_ToggleToggleStatePropertyId событие изменения свойства. |
Комментарии
Если в пользовательском интерфейсе есть видимая кнопка для переключения поведения элемента управления "Семантический масштаб", эта кнопка не должна иметь тип элемента управления SemanticZoom . Это нелогично, но тип элемента управления SemanticZoom характеризует контейнер масштабизуемого содержимого, а не кнопку, которая управляет масштабированием. (Такая кнопка может быть представлена просто как тип элемента управления Button с шаблоном переключения элемента управления.)
Связанные темы
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по