IDirectManipulationViewport：：SyncDisplayTransform 方法 (directmanipulation.h)

指定檢視區的顯示轉換，並將輸出轉換與顯示轉換的新值同步處理。

語法

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

[in] matrix

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

[in] pointCount

轉換矩陣的大小。這個值一律為 6，因為 3x2 矩陣會用於所有直接操作轉換。

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

如果應用程式執行撰寫器外部內容的特殊輸出處理， (檢視區轉換中未完全擷取的內容) ，它應該呼叫此方法來指定特殊處理的顯示轉換。

顯示轉換會影響操作更新套用至輸出轉換的方式。例如，如果顯示轉換設定為縮放 3 倍，移動流覽將會移動內容 3 倍的原始距離。

使用此方法變更顯示器轉換時，輸出轉換將會同步處理至顯示轉換的新值。

如果檢視區狀態 為DIRECTMANIPULATION_RUNNING 或 DIRECTMANIPULATION_INERTIA，則無法呼叫此方法。