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

Статья
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 элемента управления типа Group. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления UI Automation.

Элемент управления Group представляет собой узел в иерархии. Тип элемента управления Group создает разделение в дереве UI Automation, чтобы элементы, сгруппированные вместе, имели логическое деление в дереве UI Automation.

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

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

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

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

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

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

Группа

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

Группа

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

Обычно элементы управления Group имеют типы элементов управленияПоддержка автоматизированного пользовательского интерфейса для типа элемента управления ListItem, Поддержка автоматизации пользовательского интерфейса для типа элемента управления TreeItem или Поддержка автоматизации пользовательского интерфейса для элемента управления типа DataItem в своем поддереве. Так как "Group" представляет собой универсальный контейнер, под элементом управления Group в дереве могут находиться любые типы элементов управления.

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty	См. примечания.	Поддерживается при наличии ограничивающего прямоугольника. Если выполняется специализированная проверка нажатия и не все точки внутри ограничивающего прямоугольника можно выбрать с помощью мыши, то следует выполнить переопределение и указать точку, которую можно выбрать с помощью мыши.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
NameProperty	См. примечания.	Элемент управления Group обычно получает имя на основе текста подписи элемента управления.
LabeledByProperty	См. примечания.	Элементы управления Group обычно являются самомаркируемыми. В этих случаях возвращается значение null. Если существует статическая текстовая подпись для элемента управления Group, то она должна возвращаться как значение LabeledBy свойства.
ControlTypeProperty	Группа	Это значение одинаково для всех структур пользовательского интерфейса.
LocalizedControlTypeProperty	"группа"	Локализованная строка, соответствующая типу элемента управления Group.
IsContentElementProperty	True	Элемент управления Group всегда включается в представление содержания дерева UI Automation.
IsControlElementProperty	True	Сalendar group всегда включается в представление содержания дерева UI Automation.

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

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

Шаблон элемента управления	Поддержка	Примечания
IExpandCollapseProvider	Зависит от конкретного случая	Элементы управления типа Group, используемые для отображения или скрытия информации, должны поддерживать шаблон развертывания / свертывания.

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

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

Событие UI Automation	Поддержка	Примечания
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Требуется	Нет
Событие, изменяемое свойством ExpandCollapseStateProperty.	Зависит от конкретного случая	Нет
Событие, изменяемое свойством ToggleStateProperty.	Зависит от конкретного случая	Нет
AutomationFocusChangedEvent	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет

См. также

Ссылки

Group

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

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

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

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