实现 UI 自动化 Transform 控件模式

更新:2007 年 11 月

本主题介绍实现 ITransformProvider 的准则和约定,其中包括有关属性、方法和事件的信息。本主题的结尾列出了指向其他参考资料的链接。

TransformPattern 控件模式用于支持可在二维空间移动、调整大小或旋转的控件。有关实现此控件模式的控件示例,请参见 UI 自动化客户端的控件模式映射

本主题包括下列各节。

  • 实现准则和约定
  • ITransformProvider 必需的成员
  • 异常
  • 相关主题

实现准则和约定

实现 Transform 控件模式时,请注意以下准则和约定:

  • 对此控件模式的支持并不限于桌面上的对象。如果某个容器对象的子对象可以在该容器的边界内自由移动、调整大小或旋转,子对象也必须支持此控件模式。

  • 对对象进行移动、调整大小或旋转之后不能使生成的屏幕位置完全位于对象容器的坐标以外,从而无法使用键盘或鼠标进行访问(例如,当顶级窗口被移动到屏幕以外,或者子对象被移出容器视区的边界时)。在这些情况下,对象被放在尽可能靠近所请求屏幕坐标的位置,并重写顶坐标或左坐标,以使对象位于容器的边界内。

  • 对于具有多个监视器的系统,如果移动、调整大小或旋转对象后,该对象完全位于组合的桌面屏幕坐标之外,那么会将该对象放置到尽可能靠近所请求坐标的主监视器上。

  • 所有参数和属性值都是绝对值,并且与区域设置无关。

ITransformProvider 必需的成员

实现 ITransformProvider 需要以下属性和方法。

必需的成员

成员类型

说明

CanMove

属性

CanResize

属性

CanRotate

属性

Move

方法

Resize

方法

Rotate

方法

没有与此控件模式关联的事件。

异常

提供程序必须引发以下异常。

异常类型

条件

InvalidOperationException

Move

InvalidOperationException

Resize

InvalidOperationException

Rotate

请参见

任务

在 UI 自动化提供程序中支持控件模式

在 UI 自动化中使用缓存

概念

UI 自动化控件模式概述

客户端的 UI 自动化控件模式

UI 自动化树概述