SetViewportExtEx 函式 (wingdi.h)

發行項
08/27/2023

SetViewportExtEx函式會使用指定的值，為裝置內容設定檢視區的水準和垂直範圍。

語法

BOOL SetViewportExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

參數

[in] hdc

裝置內容的控制碼。

[in] x

檢視區的水準範圍，以裝置單位為單位。

[in] y

檢視區的垂直範圍，以裝置單位為單位。

[out] lpsz

以裝置單位接收先前檢視區範圍之 SIZE 結構的指標。如果 lpSize 為 Null，則不會使用此參數。

傳回值

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

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

備註

檢視區是指裝置空間的裝置座標系統。範圍是座標軸的最大值。此函式會在裝置座標 (或圖元) 設定檢視區的水準軸和垂直軸最大值。在頁面空間與裝置空間之間對應時， SetWindowExtEx 和 SetViewportExEx 會決定視窗與檢視區之間的縮放比例。如需詳細資訊，請參閱座標空間的轉換。

設定下列對應模式時，會忽略對 SetWindowExtEx 和 SetViewportExtEx 函式的呼叫。

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

設定MM_ISOTROPIC模式時，應用程式必須先呼叫 SetWindowExtEx 函式，才能呼叫 SetViewportExtEx。請注意，對於MM_ISOTROPIC模式，非四方畫面的某些部分可能無法顯示，因為兩個軸上的邏輯單位都代表相等的實體距離。

範例

如需範例，請參閱使工作區失效。

規格需求


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