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

Тип элемента управления TAB

  • Статья

В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления Tab.

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Tab. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления табуляции, где платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.

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

Типичная структура дерева

В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления вкладками и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.

Представление элемента управления Представление содержимого
  • Вешалка
    • TabItem (1 или более)
    • ScrollBar (0 или 1)
      • Кнопка (0 или 2)
  • Вешалка
    • TabItem (1 или более)

 

Элементы управления TAB имеют дочерние элементы автоматизации пользовательского интерфейса на основе типа элемента управления TabItem. Если элементы вкладки группируются (например, как в приложениях Microsoft Office), тип элемента управления tab также может размещать типы элементов управления группы для элементов сгруппированных вкладок, как показано в следующей структуре дерева.

Представление элемента управления Представление содержимого
  • Вешалка
    • TabItem (1 или более)
    • Группа (0 или более)
      • TabItem (0 или более)
    • ScrollBar (0 или 1)
      • Кнопка (0 или 2)
  • Вешалка
    • TabItem (1 или более)
    • Группа (0 или более)
      • TabItem (0 или более)

 

Соответствующие свойства

В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значения или определения которых особенно важны для элементов управления вкладками. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId Нет Элемент управления вкладки не имеет точек, доступных для щелчка.
UIA_ControlTypePropertyId вкладка
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления tab всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления tab всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId ИСТИННЫЙ Тип элемента управления TAB должен иметь возможность получать фокус клавиатуры. Как правило, клиент автоматизации пользовательского интерфейса вызывает IUIAutomationElement::SetFocus на вкладке, а один из его элементов перенаправит фокус клавиатуры на элемент управления табуляции. Для некоторых контейнеров вкладок можно сосредоточиться, не устанавливая фокус на один из его элементов.
UIA_LabeledByPropertyId См. заметки. Элементы управления TAB обычно имеют статическую текстовую метку, которая предоставляется с помощью этого свойства.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления Tab. Значение по умолчанию — tab для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Элемент управления tab редко требует свойства Name.
UIA_OrientationPropertyId См. заметки. Элемент управления табуляции всегда должен указывать, расположен ли он по горизонтали или по вертикали.

 

Обязательные шаблоны элементов управления

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

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания
ISelectionProvider Обязательно Все элементы управления вкладками должны поддерживать шаблон элемента управления выбора.
IsSelectionRequired ИСТИННЫЙ Элементы управления tab всегда требуют выбора.
CanSelectMultiple ЛОЖНЫЙ Элементы управления tab всегда являются контейнерами с одним выделением.
IScrollProvider Зависит Шаблон элемента управления прокрутки должен поддерживаться, если элемент управления вкладки содержит мини-приложения, позволяющие прокручивать набор элементов вкладки.

 

Обязательные события

В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления вкладками. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
событие UIA_ScrollHorizontallyScrollablePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollHorizontalScrollPercentPropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_ScrollHorizontalViewSizePropertyId событие, измененное свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollVerticallyScrollablePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
событие UIA_ScrollVerticalScrollPercentPropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие.
UIA_StructureChangedEventId

 

концептуальные

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

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