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

Реализация шаблона управления для UI-автоматизации преобразования

Замечание

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

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

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

Рекомендации по реализации и соглашения

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

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

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

  • Для систем с несколькими мониторами, если объект перемещается, изменяется или поворачивается полностью за пределами объединенных координат экрана рабочего стола, объект помещается на основной монитор как можно ближе к запрошенным координатам.

  • Все параметры и значения свойств являются абсолютными и независимыми от языкового стандарта.

Обязательные элементы для ITransformProvider

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

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

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

Исключения

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

Тип исключения Состояние
InvalidOperationException Move

Если CanMoveProperty false.
InvalidOperationException Resize

Если CanResizeProperty false.
InvalidOperationException Rotate

Если CanRotateProperty false.

См. также