轉換控制項模式

描述實作ITransformProvider 和 ITransformProvider2的指導方針和慣例,包括屬性和方法的相關資訊。 轉換控制項模式可用來支援可在二維空間內移動、調整大小或旋轉的控制項。

如需實作此控制項模式的控制項範例,請參閱 控制項類型及其支援的控制項模式

本主題包含下列各節。

實作方針和慣例

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

  • 此控制項模式的支援不限於桌面上的物件。 若容器物件的子項可以自由在容器的範圍內移動、調整大小或旋轉,則這些子項也必須支援此控制項模式。
  • 如果物件最後在螢幕上的位置完全在其容器的座標以外,而鍵盤或滑鼠存取不到的話,就無法移動、調整大小或旋轉物件 (例如,最上層的視窗移離螢幕,或是子物件移到容器檢視區範圍以外的地方)。 在這種情況下,物件會放置到最接近所要求螢幕座標的地方,其上方或左方座標會覆寫成容器範圍內的座標。
  • 針對多監視器系統,若物件移動、調整大小或旋轉後的位置完全超出合併桌面螢幕座標的範圍,物件就會移至主要監視器上最接近所要求座標的位置。
  • 所有參數和屬性值都是絕對值,不受地區設定影響。

ITransformProvider的必要成員

實作 ITransformProvider 介面時,需要下列屬性和方法。

必要成員 成員類型 備註
CanMove 屬性
CanResize 屬性
CanRotate 屬性
移動 方法
調整大小 方法
Rotate 方法

 

實作 ITransformProvider2 介面需要下列額外的屬性和方法。

必要成員 成員類型 備註
CanZoom 屬性
Zoom 方法
ZoomByUnit 方法
ZoomLevel 屬性
ZoomMaximum 屬性
ZoomMinimum 屬性

 

此控制項模式沒有任何相關聯的事件。

控制項類型及其支援的控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀