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

Статья
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.

В этом разделе рассматриваются рекомендации и правила для реализации IWindowProvider, в том числе сведения о свойствах, методах и событиях WindowPattern. Ссылки на дополнительные материалы перечислены в конце раздела.

Шаблон элемента управления WindowPattern используется для поддержки элементов управления, которые обеспечивают фундаментальную оконную функциональность в традиционном graphical user interface (GUI). В примеры элементов управления, которые должны реализовывать этот шаблон, включены окна верхнего уровня приложений, дочерние окна multiple-document interface (MDI), изменяемые в размере панели с разбивкой, модальные диалоговые окна и всплывающие окна подсказок.

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

Правила и соглашения по реализации
Необходимые элементы для IWindowProvider
Исключения
Связанные разделы

Правила и соглашения по реализации

При реализации шаблона элемента управления Window следует обратить внимание на следующие правила и соглашения:

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

Необходимые элементы для IWindowProvider

Следующие свойства, методы и события необходимы для интерфейса IWindowProvider.

Обязательный член	Тип члена	Примечания
InteractionState	Свойство	Нет
IsModal	Свойство	Нет
IsTopmost	Свойство	Нет
Maximizable	Свойство	Нет
Minimizable	Свойство	Нет
VisualState	Свойство	Нет
Close	Метод	Нет
SetVisualState	Метод	Нет
WaitForInputIdle	Метод	Нет
WindowClosedEvent	Событие	Нет
WindowOpenedEvent	Событие	Нет
WindowInteractionState	Событие	Не гарантируется, что будет ReadyForUserInteraction

Исключения

Поставщики должны вызывать следующие исключения.

Тип исключения	Атрибут Condition
InvalidOperationException	SetVisualState Если элемент управления не поддерживает запрошенное поведение.
ArgumentOutOfRangeException	WaitForInputIdle Если параметр не является допустимым числом.

InvalidOperationException

SetVisualState