Fungsi SetWindowExtEx (wingdi.h)

Artikel
03/13/2024

Fungsi SetWindowExtEx mengatur jangkauan horizontal dan vertikal jendela untuk konteks perangkat dengan menggunakan nilai yang ditentukan.

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Jangkauan horizontal jendela dalam unit logis.

[in] y

Jangkauan vertikal jendela dalam unit logis.

[out] lpsz

Penunjuk ke struktur SIZE yang menerima jangkauan jendela sebelumnya, di unit logis. 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

Jendela mengacu pada sistem koordinat logis ruang halaman. Jangkauannya adalah nilai maksimum sumbu. Fungsi ini mengatur nilai maksimum untuk sumbu horizontal dan vertikal jendela (dalam koordinat logis). Saat memetakan antara ruang halaman dan ruang perangkat, SetViewportExtEx dan SetWindowExtEx 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

Saat 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

Persyaratan	Nilai
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