Поддержка UI Automation для типа элемента управления Tab
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о модель автоматизации пользовательского интерфейса поддержке типа элемента управления Tab. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, значениям свойств модель автоматизации пользовательского интерфейса и модель автоматизации пользовательского интерфейса. .
Элемент управления "Вкладка" является аналогом разделителей в записной книжке или меток в картотеке. С помощью элемента управления "Вкладка" приложение может определить несколько страниц для одной области окна или диалогового окна.
В следующих разделах определяется необходимая структура дерева модель автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления TAB. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления вкладками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления вкладками, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
Вкладка
|
Вкладка — TabItem (1 или более) |
Элементы управления TAB имеют дочерние элементы модель автоматизации пользовательского интерфейса на основе типа элемента управления TAB. Если элементы вкладки сгруппированы (например, как в приложениях Microsoft Office 2007), типа элемента управления Tab может также содержать типы элемента управления Groups для сгруппированных элементов вкладки, как показано в следующей структуре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
Вкладка
|
Вкладка
|
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно относится к типу элемента управления Tab. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Для элемента управления "Вкладка" редко требуется свойство Name. |
| ClickablePointProperty | No | Элемент управления "Вкладка" не имеет активной точки. |
| LabeledByProperty | См. примечания. | Элементы управления "Вкладка" обычно имеют метку со статическим текстом, на который ссылается это свойство. |
| ControlTypeProperty | Вкладка | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "вкладка" | Локализованная строка, соответствующая типу элемента управления Tab. |
| IsKeyboardFocusableProperty | Истина | Тип элемента управления Tab должен иметь возможность получать фокус клавиатуры. Как правило, клиент модель автоматизации пользовательского интерфейса вызывает SetFocus на элементе управления табуляции, а один из его элементов перенаправит фокус клавиатуры на элемент управления табуляции. Некоторые контейнеры вкладок могут получать фокус без установки фокуса в одном из их элементов. |
| IsContentElementProperty | Истина | Элемент управления вкладками всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элемент управления tab всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| OrientationProperty | См. примечания. | Элемент управления "Вкладка" должен всегда указывать, располагается ли он горизонтально или вертикально. |
Необходимые шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления табуляции. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания. |
|---|---|---|
| ISelectionProvider | Да | Все элементы управления "Вкладка" должны поддерживать шаблон Selection. |
| IsSelectionRequired | Истина | Элементы управления "Вкладка" всегда требуют, чтобы был сделан выбор. |
| CanSelectMultiple | False | Элементы управления "Вкладка" всегда являются контейнерами с возможностью выбора одного варианта. |
| IScrollProvider | Зависит | Шаблон Scroll, который должен поддерживаться в элементе управления "Вкладка", имеет мини-приложения, которые позволяют прокручивать набор элементов вкладки. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления вкладками. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Зависит | нет |
| Событие изменения свойстваHorizontalScrollPercentProperty | Зависит | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Зависит | нет |
| Событие изменения свойстваHorizontalViewSizeProperty | Зависит | нет |
| Событие изменения свойстваVerticalScrollPercentProperty | Зависит | нет |
| Событие изменения свойстваVerticalViewSizeProperty | Зависит | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |