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

Поддержка UI Automation для типа элемента управления Tab

  • Статья
ПримечаниеПримечание

Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

Этот раздел содержит сведения о поддержке UI Automation для типа элемента управления "Вкладка". В UI Automation тип элемента управления представляет собой набор условий, которым должен удовлетворять элемент управления, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся особые указания по древовидной структуре UI AutomationUI Automation property values and UI Automation и шаблонов элемента управления.

Вкладка является аналогом разделителей в записной книжке или наклеек в CAB-файле. С помощью вкладки приложение можно определить несколько страниц для одной области окна или диалогового окна.

В следующих разделах определяются необходимые древовидная структура UI Automation, свойства, шаблоны элементов управления и события для типа элемента управления Tab. Требования UI Automation применяются ко всем перечисленным элементам управления типа tab, независимо от Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

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

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

Представление элементов управления

Представление содержимого

Вкладка

  • TabItem (1 или более)

  • Полоса прокрутки (0, или 1)

    • Кнопка (0 или 2)

Вкладка

  • TabItem (1 или более)

Вкладки имеет дочерние элементы UI Automation основанная на типе элемента управления Tab Item. Если элементы вкладки сгруппированы (как, например, в приложениях Microsoft Office 2007), тип элемента управления "Вкладка" может содержать типы элемента управления группами для сгруппированных элементов вкладки, как показано на приведенной ниже древовидной структуре.

Представление элементов управления

Представление содержимого

Вкладка

  • TabItem (1 или более)

  • Group (0 или более)

    • TabItem (0 или более)

  • ScrollBar (0 или более)

    • Кнопка (0 или 2)

Вкладка

  • TabItem (1 или более)

  • Group (0 или более)

    • TabItem (0 или более)

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

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

Свойство UI Automation

Значение

Примечания

AutomationIdProperty

См. примечания.

Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.

BoundingRectangleProperty

См. примечания.

Внешний прямоугольник, содержащий весь элемент управления.

IsKeyboardFocusableProperty

См. примечания.

Если элемент управления может получать фокус ввода с клавиатуры, он должен поддерживать это свойство.

NameProperty

См. примечания.

Вкладка редко требует свойства Name.

ClickablePointProperty

Нет

Вкладка не имеет точки, активизируемой щелчком мыши.

LabeledByProperty

См. примечания.

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

ControlTypeProperty

Вкладка

Это значение одинаково для всех структур пользовательского интерфейса.

LocalizedControlTypeProperty

"вкладка"

Локализованная строка, соответствующая элементу управления Tab.

IsKeyboardFocusableProperty

True

Элемент управления Tab должен иметь возможность получить фокус клавиатуры. Как правило, клиент UI Automation вызывает SetFocus для элемента управления Tab и один из его элементов будет пересылать фокус клавиатуры элементу управления Tab. Для некоторых контейнеров вкладок возможна передача фокуса без установки фокуса одному из его элементов.

IsContentElementProperty

True

Элемент управления Tab всегда включается в представление содержимого дерева UI Automation.

IsControlElementProperty

True

Элемент управления Tab всегда включается в представление элемента управления дерева UI Automation.

OrientationProperty

См. примечания.

Элемент управления Tab должен всегда указывать располагается ли он горизонтально или вертикально.

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

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

Шаблон элемента управления/свойство шаблона

Поддержка /значение

Примечания

ISelectionProvider

Да

Все элементы управления Tab должны поддерживать шаблон Selection.

IsSelectionRequired

True

Для элемента управления Tab всегда требуется, чтобы было выделение.

CanSelectMultiple

False

Элементы управления Tab всегда являются контейнерами с единичным выделением.

IScrollProvider

Зависит от конкретного случая

Шаблон Scroll, который должен поддерживаться в элементе управления Tab, имеет элементы, которые позволяют прокручивать набор элементов вкладки.

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

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

Событие UI Automation

Поддержка

Примечания

Событие, изменяемое свойством BoundingRectangleProperty.

Обязательно

Нет

Событие, изменяемое свойством IsOffscreenProperty.

Требуется

Нет

Событие, изменяемое свойством IsEnabledProperty.

Требуется

Нет

Событие, изменяемое свойством HorizontallyScrollableProperty.

Зависит от конкретного случая

Нет

Событие, изменяемое свойством HorizontalScrollPercentProperty.

Зависит от конкретного случая

Нет

Событие, изменяемое свойством HorizontallyScrollableProperty.

Зависит от конкретного случая

Нет

Событие, изменяемое свойством HorizontalViewSizeProperty.

Зависит от конкретного случая

Нет

Событие, изменяемое свойством VerticalScrollPercentProperty.

Зависит от конкретного случая

Нет

Событие, изменяемое свойством VerticalViewSizeProperty.

Зависит от конкретного случая

Нет

AutomationFocusChangedEvent

Обязательно

Нет

StructureChangedEvent

Обязательно

Нет

См. также

Ссылки

Tab

Основные понятия

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

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