Fungsi SetViewportExtEx (wingdi.h)

Artikel
03/08/2023

Fungsi SetViewportExtEx mengatur tingkat horizontal dan vertikal viewport untuk konteks perangkat dengan menggunakan nilai yang ditentukan.

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Jangkauan horizontal, dalam unit perangkat, dari viewport.

[in] y

Jangkauan vertikal, dalam unit perangkat, dari viewport.

[out] lpsz

Penunjuk ke struktur SIZE yang menerima jangkauan viewport sebelumnya, di unit perangkat. Jika lpSize adalah NULL, parameter ini tidak digunakan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Viewport mengacu pada sistem koordinat perangkat dari ruang perangkat. Jangkauannya adalah nilai maksimum sumbu. Fungsi ini mengatur nilai maksimum untuk sumbu horizontal dan vertikal viewport dalam koordinat perangkat (atau piksel). Saat memetakan antara ruang halaman dan ruang perangkat, SetWindowExtEx dan SetViewportExtEx menentukan faktor penskalaan antara jendela dan viewport. Untuk informasi selengkapnya, lihat Transformasi Ruang Koordinat.

Saat mode pemetaan berikut diatur, panggilan ke fungsi SetWindowExtEx dan SetViewportExtEx diabaikan.

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Ketika mode MM_ISOTROPIC diatur, aplikasi harus memanggil fungsi SetWindowExtEx sebelum memanggil SetViewportExtEx. Perhatikan bahwa untuk mode MM_ISOTROPIC bagian tertentu dari layar yang tidak sama mungkin tidak tersedia untuk ditampilkan karena unit logis pada kedua sumbu mewakili jarak fisik yang sama.

Contoh

Misalnya, lihat Membatalkan Area Klien.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll