Поддержка Автоматизации Пользовательского Интерфейса для Элементов Управления Типа "Заголовок Окна"
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о модель автоматизации пользовательского интерфейса поддержке типа элемента управления TitleBar. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Элементы управления "Заголовок окна" представляют названия или заголовки в окне.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления TitleBar. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления строк заголовка, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления заголовком и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| TitleBar - Меню (0 или 1) - Кнопка (0 или более) |
Неприменимо. (элемент управления "Заголовок окна" не имеет содержимого.) |
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно важно для элементов управления TitleBar. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Ограничивающий прямоугольник заголовка окна должен охватывать все элементы управления, содержащиеся в нем. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| IsKeyboardFocusableProperty | False | Заголовки окон никогда не получают фокус клавиатуры. |
| NameProperty | "" | Заголовок окна не является содержимым; его текстовая информация отображается в родительском окне. |
| LabeledByProperty | См. примечания. | Элемент управления "Заголовок окна" обычно не имеет метки. |
| ControlTypeProperty | TitleBar | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "заголовок окна" | Локализованная строка, соответствующая типу элемента управления TitleBar. |
| IsContentElementProperty | False | Элемент управления "Заголовок окна" никогда не является содержимым. |
| IsControlElementProperty | Истина | Элемент управления "Заголовок окна" всегда должен быть элементом управления. |
| IsOffscreenProperty | Зависит | Этот элемент управления будет возвращать значение в зависимости от того, отображается ли заголовок окна на экране. |
| HelpTextProperty | "" | Отображать текст справки не обязательно. |
| AcceleratorKeyProperty | "" | Заголовки окна никогда не имеют клавиш быстрого доступа. |
| AccessKeyProperty | "" | Элемент управления "Заголовок окна" не имеет клавиши доступа. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
Не требуется, чтобы тип элемента управления TitleBar поддерживал какой-либо шаблон элемента управления. Его функциональность предоставляется с помощью шаблона элемента управления Window в элементе управления "Окно".
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления заголовка. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Никогда | нет |
| AutomationFocusChangedEvent | Никогда | нет |
| StructureChangedEvent | Обязательное поле | нет |