Поддержка автоматизации пользовательского интерфейса для элемента управления Pane

Статья
08/11/2011

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

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

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

Тип элементов управления Pane используется для представления объектов во фрейме или окне документа. Допускается переходить от одной панели к другой и внутри содержимого текущей панели, но нельзя переходить от элемента одной панели к элементу в другой панели. Таким образом, панели представляют уровень группировки ниже, чем окна или документы, но выше, чем отдельные элементы управления. Переход от одной панели к другой выполняется нажатием клавиш TAB, F6 или CTRL+TAB, в зависимости от контекста. Для элемента управления типа Pane не требуется никакой специальной навигации посредством ключевых слов.

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

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

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

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

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

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

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус ввода с клавиатуры, он должен поддерживать это свойство.
NameProperty	См. примечания.	Значение для этого свойства всегда должно быть понятным, кратким и осмысленным заголовком.
ClickablePointProperty	См. примечания.	Это свойство предоставляет активную точку, при щелчке которой фокус перемещается на данную панель.
LabeledByProperty	См. примечания.	Как правило, панели не имеют статической подписи. При наличии статической подписи она должна быть предоставлена с помощью этого свойства.
ControlTypeProperty	Панель	Это значение одинаково для всех структур UI.
LocalizedControlTypeProperty	"pane"	Локализованная строка, соответствующая типу элемента управления Pane.
IsContentElementProperty	True	Панели всегда включаются в представление содержимого дерева UI Automation.
IsControlElementProperty	True	Панели всегда включаются в представление элемента управления дерева UI Automation.
HelpTextProperty	""	Текст справки для элементов управления панели должен пояснять назначение каждого фрейма и его отношение к другим фреймам. Описание необходимо, если назначение и взаимоотношение фреймов не ясно из значения NameProperty. "
AccessKeyProperty	См. примечания.	Если для перевода фокуса на данную панель служит определенное сочетание клавиш, сведения об этом должны быть предоставлена с помощью этого свойства.

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

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

Шаблон элемента управления	Поддержка	Примечания
ITransformProvider	Зависит от конкретного случая	Реализуйте этот шаблон элемента управления, если панель допускает перемещение, изменение размеров или поворот на экране.
IWindowProvider	Никогда	Если требуется реализовать этот шаблон элемента управления, то элемент управления должен быть основан на типе элементов управления Window.
IDockProvider	Зависит от конкретного случая	Реализует этот шаблон элемента управления, если панель может быть закреплена.
IScrollProvider	Зависит от конкретного случая	Реализует этот шаблон элемента управления, если элемент управления Pane может прокручиваться.

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

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

Событие UI Automation	Поддержка/значение	Примечания
WindowClosedEvent	Никогда	Нет
WindowOpenedEvent	Никогда	Нет
AsyncContentLoadedEvent	Обязательно	Нет
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Требуется	Нет
Событие, изменяемое свойством HorizontallyScrollableProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством HorizontalScrollPercentProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством HorizontalViewSizeProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством VerticalScrollPercentProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством VerticallyScrollableProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством VerticalViewSizeProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством WindowVisualStateProperty.	Никогда	Нет
AutomationFocusChangedEvent	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет

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

На следующем рисунке показан элемент управления, который реализует тип элемента управления Pane.

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

Дерево UI Automation — представление элемента управления	Дерево UI Automation — представление содержимого
Панель Tree (шаблон Scroll) TreeItem Панель Edit (Scroll Pattern)	Панель Tree (шаблон Scroll) TreeItem …Pane Edit (Scroll Pattern)