Реализация шаблона элемента управления преобразованиями модели автоматизации пользовательского интерфейса
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе приводятся рекомендации и соглашения для реализации ITransformProvider, включая сведения о свойствах, методах и событиях. Ссылки на дополнительные материалы перечислены в конце раздела.
Шаблон элемента управления TransformPattern используется для поддержки элементов управления, которые можно перемещать, поворачивать или изменять их размер в двумерном пространстве. Примеры элементов управления, реализующие данный шаблон элемента управления, см. в разделе Control Pattern Mapping for UI Automation Clients.
Правила и соглашения реализации
При реализации шаблона элемента управления Transform обратите внимание на следующие правила и соглашения.
Поддержка этого шаблона элемента управления не ограничена объектами на рабочем столе. Этот шаблон элемента управления также должен поддерживаться дочерними элементами объекта контейнера, если эти дочерние элементы можно перемещать, изменять их размер или свободно поворачивать в пределах контейнера.
Объект нельзя перемещать, изменять его размер или поворачивать таким образом, что его итоговое положение на экране окажется полностью вне координат своего контейнера и поэтому он станет недоступным для клавиатуры или мыши (например, когда окно верхнего уровня перемещается за пределы экрана или дочерний объект перемещается за пределы границ окна просмотра контейнера). В этих случаях объект помещается максимально близко к запрошенным экранным координатам с переопределением верхней или левой координаты, чтобы они находились в границах контейнера.
Для систем с несколькими мониторами при перемещении объекта, изменении его размера или повороте полностью за пределами координат объединенного рабочего стола объект помещается на основном мониторе максимально близко к запрошенным координатам.
Все параметры и значения свойств являются абсолютными и не зависят от языка и региональных параметров.
Обязательные члены для ITransformProvider
Следующие свойства и методы обязательны для реализации ITransformProvider.
| Обязательные члены | Тип члена | Примечания. |
|---|---|---|
| CanMove | Свойство | нет |
| CanResize | Свойство | нет |
| CanRotate | Свойство | нет |
| Move | Способ | нет |
| Resize | Способ | нет |
| Rotate | Способ | нет |
Этот шаблон элемента управления не имеет связанных событий.
Исключения
Поставщики должны вызывать следующие исключения.
| Тип исключения | Condition |
|---|---|
| InvalidOperationException | Move — Значение CanMoveProperty false. |
| InvalidOperationException | Resize — Значение CanResizeProperty false. |
| InvalidOperationException | Rotate — Значение CanRotateProperty false. |
См. также
- Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса
- Поддержка шаблонов элементов управления в поставщике автоматизации пользовательского интерфейса
- Шаблоны элементов управления модели автоматизации пользовательского интерфейса для клиентов
- Общие сведения о дереве модели автоматизации пользовательского интерфейса
- Использование кэширования в модели автоматизации пользовательского интерфейса