共用方式為


IDirectManipulationViewport::SetViewportTransform 方法 (directmanipulation.h)

指定從檢視區座標系統到視窗用戶端座標系統的轉換。

語法

HRESULT SetViewportTransform(
  [in] const float *matrix,
  [in] DWORD       pointCount
);

參數

[in] matrix

轉換矩陣,依資料列順序排列:_11、_12、_21、_22、_31、_32。

[in] pointCount

轉換矩陣的大小。 此值一律為 6,因為所有直接操作轉換都會使用 3x2 矩陣。

傳回值

如果方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

呼叫此函式以指定畫面上的檢視區位置、縮放比例和方向。 檢視區位置、縮放比例、方向和大小都是由檢視區轉換和檢視區矩形唯一決定。 應用程式可以使用此方法指定檢視區轉換,以及使用 SetViewportRect的檢視區矩形。

檢視區矩形 (檢視區座標中指定使用者) 可見內容的矩形區域。 如果檢視區矩形左上角 (0,0) ,則檢視區矩形會完全位於檢視區座標系統原點。 檢視區座標系統原點的檢視區位移可以透過兩種方式指定:

  • 透過檢視區矩形左上角點
  • 透過檢視區轉換轉譯元件 (_31_32)
檢視區轉換會從檢視區座標系統轉換為視窗用戶端座標系統。 直接操作 會忽略視窗 RTL 屬性,因此工作區原點一律為左上方。 轉換會依下列順序套用:
  1. 檢視區矩形位移
  2. 檢視區從檢視區轉換 (到用戶端座標系統)
  3. 用戶端對螢幕對應 (從用戶端到螢幕座標系統)

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 directmanipulation.h

另請參閱

IDirectManipulationViewport