共用方式為

IOleControlSite：：TransformCoords 方法 (ocidl.h)

  • 發行項

將 以 HIMETRIC 單位表示的座標， (為 OLE) 的標準單位轉換為容器所指定的單位。

語法

HRESULT TransformCoords(
  [in, out] POINTL *pPtlHimetric,
  [in, out] POINTF *pPtfContainer,
  [in]      DWORD  dwFlags
);

參數

[in, out] pPtlHimetric

POINTL結構的位址，其中包含以 HIMETRIC單位表示的座標。 當 dwFlags 包含XFORMCOORDS_HIMETRICTOCONTAINER時，這是 [in] 參數;它是具有 XFORMCOORDS_CONTAINERTOHIMETRIC 的 [out] 參數。 在後者的情況下，內容在錯誤時是未定義的。

[in, out] pPtfContainer

接收已轉換座標之呼叫端配置的 POINTF 結構的位址。 當 dwFlags 包含XFORMCOORDS_CONTAINERTOHIMETRIC時，這是 [in] 參數;它是具有 XFORMCOORDS_HIMETRICTOCONTAINER 的 [out] 參數。 在後者的情況下，內容在錯誤時是未定義的。

[in] dwFlags

指出要執行之確切轉換的旗標。 此參數可以是下列值的任何組合，但如所述。

值 意義
XFORMCOORDS_POSITION
0x1
 要轉換的座標代表位置點。 無法與XFORMCOORDS_SIZE搭配使用。
XFORMCOORDS_SIZE
0x2
 要轉換的座標代表一組維度。 無法與XFORMCOORDS_POSITION搭配使用。
XFORMCOORDS_HIMETRICTOCONTAINER
0x4
 作業會將 pptlHimetric 轉換成 pptfContainer。 無法與XFORMCOORDS_CONTAINERTOHIMETRIC搭配使用。
XFORMCOORDS_CONTAINERTOHIMETRIC
0x8
 此作業會將 pptfContainer 轉換成 pptlHimetric。 無法與XFORMCOORDS_HIMETRICTOCONTAINER搭配使用。
XFORMCOORDS_EVENTCOMPAT
0x10
 此作業會維持與事件的相容性。

傳回值

這個方法可以傳回標準傳回值E_INVALIDARG和E_UNEXPECTED，以及下列值。

傳回碼 描述
S_OK
 已成功完成命令。
E_NOTIMPL
 容器不需要任何特殊的座標轉換。 容器會在 HIMETRIC中完全處理。
E_POINTER
 pPtlHimetric或pPtfContainer中的位址無效。 例如，它可能是 Null。

備註

當控制項必須將座標傳送至事件或某些其他自訂呼叫內的容器時，或是當控制項具有需要轉換成 HIMETRIC 單位的容器座標時，控制項就會使用這個方法。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IOleControlSite