setViewportOrgEx 函式 (wingdi.h)

發行項
08/27/2023

SetViewportOrgEx函式會指定哪些裝置點對應至視窗原點， (0，0) 。

語法

BOOL SetViewportOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

參數

[in] hdc

裝置內容的控制碼。

[in] x

新檢視區原點的 x 座標，以裝置單位表示。

[in] y

新檢視區原點的 Y 座標，以裝置單位表示。

[out] lppt

在裝置座標中接收先前檢視區原點之 POINT 結構的指標。如果 lpPoint 為 Null，則不會使用此參數。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

備註

此函式 (以及 SetViewportExtEx 和 SetWindowExtEx) 可協助定義邏輯座標空間 (也稱為視窗) 對應到 檢視區 (檢視區) 的裝置座標空間。 SetViewportOrgEx 會指定哪些裝置點對應至邏輯點， (0，0) 。其效果是移動座標軸，讓邏輯點 (0，0) 不再參考左上角。


//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

這與 SetWindowOrgEx 函式相關。一般而言，您將使用一個函式或其他函式，但不會同時使用這兩個函式。無論您使用 SetWindowOrgEx 和 SetViewportOrgEx，裝置點 (0，0) 一律是左上角。

範例

如需範例，請參閱在更新區域中重新繪製。

規格需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll