Тип элемента управления "Область"
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления области.
Тип элемента управления области предназначен для потенциально прокручиваемых регионов с разнородным содержимым. Он используется для представления объекта в кадре или окне документа. Пользователи могут перемещаться между элементами управления панели и в пределах содержимого текущей панели. Элементы управления панелью представляют уровень группировки ниже окон или документов, но выше отдельных элементов управления. Пользователь перемещается между панелями, нажимая клавишу TAB, F6 или CTRL+TAB в зависимости от контекста.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления области. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления, где платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- Пример типа элемента управления области
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления панели и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Элемент управления панели всегда отображается в представлениях элемента управления и содержимого. Не предоставляйте объект макета как область в элементе управления или представлении содержимого, если объект используется только для визуальной презентации.
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления панелью. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
| Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
|---|---|---|
| UIA_AccessKeyPropertyId | См. заметки. | Если определенное сочетание клавиш дает фокус области, эта информация должна быть предоставлена с помощью этого свойства. |
| UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. заметки. | Это свойство предоставляет доступную точку элемента управления панелью, которая приводит к тому, что область будет сосредоточена при щелчке. |
| UIA_ControlTypePropertyId | области | |
| UIA_HelpTextPropertyId | См. заметки. | Текст справки для элементов управления панелью должен объяснить назначение кадра и его связь с другими кадрами. Описание необходимо, если назначение и связь кадров не ясно из значения свойства UIA_NamePropertyId. |
| UIA_IsContentElementPropertyId | ИСТИННЫЙ | Элемент управления панелью всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | ИСТИННЫЙ | Элемент управления панелью всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. заметки. | Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | См. заметки. | Элементы управления панели обычно не имеют статической метки. Если имеется статическое текстовое метка, она должна быть предоставлена с помощью этого свойства. |
| UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления области . Значение по умолчанию — "область" для en-US или английского языка (США). |
| UIA_NamePropertyId | См. заметки. | Значение этого свойства всегда должно быть четким, кратким и значимым заголовком. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления панелью. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
| Шаблон элемента управления | Поддержка | Примечания |
|---|---|---|
| IDockProvider | Зависит | Реализуйте шаблон dock, если элемент управления панелью можно закрепить. |
| IScrollProvider | Зависит | Реализуйте шаблон прокрутки, если элемент управления панелью можно прокрутить. |
| ITransformProvider | Зависит | Реализуйте шаблон преобразования, если элемент управления панели можно переместить, изменить размер или повернуть на экране. |
| IWindowProvider | Никогда | Если элементу необходимо реализовать шаблон элемента управления Window, элемент управления должен быть основан на типе элемента управления Window. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления панелью. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| событие UIA_BoundingRectanglePropertyId изменено свойством. | |
| событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
| событие UIA_ScrollHorizontallyScrollablePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollHorizontalScrollPercentPropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_ScrollHorizontalViewSizePropertyId событие, измененное свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollVerticallyScrollablePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollVerticalScrollPercentPropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_StructureChangedEventId |
Пример типа элемента управления "Панель"
На следующем рисунке показан элемент управления, реализующий тип элемента управления области.
снимок экрана 
| Дерево автоматизации пользовательского интерфейса — представление элемента управления | Дерево автоматизации пользовательского интерфейса — представление содержимого |
|---|---|
|
|
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса