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

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

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

Шаблон элемента управления TransformPattern используется для поддержки элементов управления, которые могут быть перемещены, изменены в размерах или повернуты в двумерном пространстве. Примеры элементов управления, реализующие данный шаблон элемента управления, см. в разделе Сопоставление шаблона элемента управления для клиентов автоматизации пользовательского интерфейса.

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

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

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

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

Поддержка этого шаблона элемента управления не ограничена объектами на рабочем столе. Этот шаблон элемента управления должен также поддерживаться дочерними элементами объекта контейнера, если дочерние элементы могут быть перемещены, изменены в размерах или свободно повернуты в пределах контейнера.
Объект не может быть перемещен, изменен в размерах или повернут таким образом, что его результирующее расположение на экране будет полностью вне координат контейнера, в результате чего он будет недоступен для клавиатуры или мыши (например, когда окно верхнего уровня перемещено вне экрана или дочерний объект перемещен за пределы границ просмотра контейнера). В этих случаях объект помещается максимально близко к запрошенным экранным координатам, а верхняя или левая координата переопределяется так, чтобы она находилась в границах контейнера.
Для систем с несколькими мониторами при перемещении, изменении размера или повороте полностью за пределами координат объединенного рабочего стола объект помещается на основном мониторе так близко к запрошенным координатам, насколько это возможно.
Все параметры и значения свойств являются абсолютными и независимыми от языкового стандарта.

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

Для реализации ITransformProvider необходимы следующие свойства и методы.

Обязательные члены	Тип члена	Примечания
CanMove	Свойство	Нет
CanResize	Свойство	Нет
CanRotate	Свойство	Нет
Move	Метод	Нет
Resize	Метод	Нет
Rotate	Метод	Нет

Данный шаблон элемента управления не имеет связанных событий.

Исключения

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

Тип исключения	Атрибут Condition
InvalidOperationException	Move Если значение свойства CanMoveProperty — false.
InvalidOperationException	Resize Если значение свойства CanResizeProperty — false.
InvalidOperationException	Rotate Если значение свойства CanRotateProperty — false.

InvalidOperationException

Move