Fungsi SetViewportOrgEx (wingdi.h)

Artikel
08/27/2023

Fungsi SetViewportOrgEx menentukan peta titik perangkat mana ke asal jendela (0,0).

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Koordinat x, dalam unit perangkat, dari asal viewport baru.

[in] y

Koordinat y, di unit perangkat, dari asal viewport baru.

[out] lppt

Penunjuk ke struktur POINT yang menerima asal viewport sebelumnya, dalam koordinat perangkat. Jika lpPointNULL, parameter ini tidak digunakan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi ini (bersama dengan SetViewportExtEx dan SetWindowExtEx) membantu menentukan pemetaan dari ruang koordinat logis (juga dikenal sebagai jendela) ke ruang koordinat perangkat ( viewport). SetViewportOrgEx menentukan titik perangkat mana yang memetakan ke titik logis (0,0). Ini memiliki efek menggeser sumbu sehingga titik logis (0,0) tidak lagi mengacu pada sudut kiri atas.


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

Ini terkait dengan fungsi SetWindowOrgEx . Umumnya, Anda akan menggunakan satu fungsi atau yang lain, tetapi tidak keduanya. Terlepas dari penggunaan SetWindowOrgEx dan SetViewportOrgEx, titik perangkat (0,0) selalu merupakan sudut kiri atas.

Contoh

Misalnya, lihat Menggambar Ulang di Wilayah Pembaruan.

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