Поддержка Автоматизации Пользовательского Интерфейса для Элементов Управления Типа "Заголовок Окна"

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

Элементы управления "Заголовок Окна" представляют названия или заголовки панели в окне.

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

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

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

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

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

Представление элементов управления	Представление содержимого
Заголовок Окна Menu (0 или 1) Кнопка (0 или более)	Неприменимо. (Элемент управления "Заголовок окна" не имеет содержимого.)

Заголовок Окна

Menu (0 или 1)
Кнопка (0 или более)

Неприменимо. (Элемент управления "Заголовок окна" не имеет содержимого.)

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

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

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

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

Тип элемента управления "заголовок окна" не требуется для поддержки любых шаблонов управления. Его функциональные возможности предоставляются через шаблон элемента управления Window в элементе управления Window.

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

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

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

См. также

Ссылки

TitleBar

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

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

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

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