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

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

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

Элемент управления "Заголовок" предоставляет визуальный контейнер для меток строк или столбцов данных.

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

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

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

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

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

Представление элементов управления	Представление содержимого
"Заголовок" HeaderItem (1 или более)	Нет

Элементы управления "Заголовок" всегда имеют 1 или более дочерних элементов в представлении элемента управления в дереве UI Automation.

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

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty	См. примечания.	Поддерживается при наличии ограничивающего прямоугольника. Если выполняется специализированная проверка нажатия и не все точки внутри ограничивающего прямоугольника можно выбрать с помощью мыши, то следует выполнить переопределение и указать точку, которую можно выбрать с помощью мыши.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус ввода с клавиатуры, он должен поддерживать это свойство.
NameProperty	См. примечания.	Если имеется более одного заголовка строки или более одного заголовка столбца, элементу управления "Заголовок" требуется присваивать имя. Оно определяет сведения, содержащиеся в заголовке.
LabeledByProperty	Null.	Элемент управления "Заголовок" не имеет статической метки.
ControlTypeProperty	Header	Это значение одинаково для всех структур UI.
LocalizedControlTypeProperty	"header"	Это значение одинаково для всех структур UI.
OrientationProperty	Horizontal	Значение этого свойства представляет собой положение элемента управления "Заголовок" (заголовок строки или заголовок столбца).
IsContentElementProperty	False	Элемент управления "Заголовок" не включается в представление содержимого дерева UI Automation.
IsControlElementProperty	True	Элемент управления "Заголовок" всегда включается в представление содержимого дерева UI Automation.

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

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

Шаблон элемента управления	Поддержка	Примечания
ITransformProvider	Зависит от конкретного случая	Следует реализовать этот шаблон элемента управления, если размер элемента управления "Заголовок" может быть изменен.

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

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

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

См. также

Ссылки

Header

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

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

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