共用方式為


實作 UI 自動化 Transform 控制項模式

注意事項注意事項

這份文件適用於想要使用 System.Windows.Automation 命名空間中定義之 Managed UI Automation 類別的 .NET Framework 開發人員。如需 UI Automation 的最新資訊,請參閱 Windows Automation API:使用者介面自動化 (英文)。

本主題將介紹實作 ITransformProvider 的方針和慣例,包括屬性、方法和事件的相關資訊。 其他參考的連結列於此主題的結尾部分。

TransformPattern 控制項模式用來支援可在二維空間內移動、調整大小或旋轉的控制項。 如需實作此控制項模式的控制項範例,請參閱 UI 自動化用戶端的控制項模式對應

這個主題包含下列章節。

  • 實作方針和慣例
  • ITransformProvider 的必要成員
  • 例外狀況
  • 相關主題

實作方針和慣例

實作 Transform 控制項模式時,請注意下列方針和慣例:

  • 此控制項模式的支援不限於桌面上的物件。 若容器物件的子項可以自由在容器的範圍內移動、調整大小或旋轉,則這些子項也必須支援此控制項模式。

  • 如果物件最後在螢幕上的位置完全在其容器的座標以外,而鍵盤或滑鼠存取不到的話,就無法移動、調整大小或旋轉物件 (例如,最上層的視窗移離螢幕,或是子物件移到容器檢視區範圍以外的地方)。 在這種情況下,物件會放置到最接近所要求螢幕座標 (Screen Coordinate) 的地方,其上方或左方座標會覆寫成容器範圍內的座標。

  • 針對多監視器系統,若物件移動、調整大小或旋轉後的位置完全超出合併桌面螢幕座標的範圍,物件就會移至主要監視器上最接近所要求座標的位置。

  • 所有參數和屬性值都是絕對值,不受地區設定影響。

ITransformProvider 的必要成員

實作 ITransformProvider 時需要使用下列屬性和方法。

必要成員

成員類型

備註

CanMove

屬性

CanResize

屬性

CanRotate

屬性

Move

方法

Resize

方法

Rotate

方法

這個控制項模式沒有相關事件。

例外狀況

提供者必須擲回下列例外狀況。

例外狀況類型

條件

InvalidOperationException

Move

InvalidOperationException

Resize

InvalidOperationException

Rotate

請參閱

工作

支援 UI 自動化提供者的控制項模式

使用 UI 自動化中的快取

概念

UI 自動化控制項模式概觀

用戶端的 UI 自動化控制項模式

UI 自動化樹狀目錄概觀