備註
本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊，請參閱 Windows 自動化 API：使用者介面自動化。
本主題介紹實作 ITransformProvider的指導方針和慣例，包括屬性、方法和事件的相關信息。 主題結尾會列出其他參考的連結。
控制項 TransformPattern 模式可用來支援可在二維空間內移動、重設大小或旋轉的控件。 如需實作此控制項模式的控制項範例，請參閱 UI 自動化用戶端的控制項模式對應。
實作指導方針和慣例
實作轉換控件模式時，請注意下列指導方針和慣例：
此控制項模式的支援不限於桌面上的物件。 如果子系可以在容器界限內自由移動、重設大小或旋轉子系，容器物件的子系也必須支援此控件模式。
無法移動、重設大小或旋轉物件，使其產生的螢幕位置完全超出其容器的座標，因此無法存取鍵盤或滑鼠（例如，當最上層視窗移出螢幕或子物件移出容器檢視區界限時）。 在這些情況下，物件會盡可能接近要求的螢幕座標，並覆寫上或左座標以在容器界限內。
針對多監視器系統，如果對象已移動、重設大小或完全在結合桌面螢幕座標之外旋轉，物件會盡可能放在接近所要求座標的主要監視器上。
所有參數和屬性值都是絕對值，與地區設定無關。
ITransformProvider 的必要成員
實作 ITransformProvider需要下列屬性和方法。
| 必要成員 | 成員類型 | 註釋 |
|---|---|---|
| CanMove | 房產 | 沒有 |
| CanResize | 房產 | 沒有 |
| CanRotate | 房產 | 沒有 |
| Move | 方法 | 沒有 |
| Resize | 方法 | 沒有 |
| Rotate | 方法 | 沒有 |
此控制件模式沒有相關聯的事件。
例外狀況
提供者必須擲回下列例外狀況。
| 例外狀況類型 | 狀況 |
|---|---|
| InvalidOperationException | Move - 如果 CanMoveProperty 為 false。 |
| InvalidOperationException | Resize - 如果 CanResizeProperty 為 false。 |
| InvalidOperationException | Rotate - 如果 CanRotateProperty 為 false。 |