Fungsi SetMapMode (wingdi.h)

Artikel
03/04/2024

Fungsi SetMapMode mengatur mode pemetaan dari konteks perangkat yang ditentukan. Mode pemetaan menentukan unit pengukuran yang digunakan untuk mengubah unit ruang halaman menjadi unit ruang perangkat, dan juga menentukan orientasi sumbu x dan y perangkat.

Sintaks

int SetMapMode(
  [in] HDC hdc,
  [in] int iMode
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] iMode

Mode pemetaan baru. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
MM_ANISOTROPIC	Unit logis dipetakan ke unit arbitrer dengan sumbu yang diskalakan secara semena-mena. Gunakan fungsi SetWindowExtEx dan SetViewportExtEx untuk menentukan unit, orientasi, dan penskalaan.
MM_HIENGLISH	Setiap unit logis dipetakan ke 0,001 inci. Positif x ada di sebelah kanan; positif y sudah habis.
MM_HIMETRIC	Setiap unit logis dipetakan ke 0,01 milimeter. Positif x ada di sebelah kanan; positif y sudah habis.
MM_ISOTROPIC	Unit logis dipetakan ke unit arbitrer dengan sumbu yang sama skalanya; artinya, satu unit di sepanjang sumbu x sama dengan satu unit di sepanjang sumbu y. Gunakan fungsi SetWindowExtEx dan SetViewportExtEx untuk menentukan unit dan orientasi sumbu. Antarmuka perangkat grafis (GDI) membuat penyesuaian seperlunya untuk memastikan unit x dan y tetap berukuran sama (Ketika jangkauan jendela diatur, viewport akan disesuaikan untuk menjaga unit tetap isotropik).
MM_LOENGLISH	Setiap unit logis dipetakan ke 0,01 inci. Positif x ada di sebelah kanan; positif y sudah habis.
MM_LOMETRIC	Setiap unit logis dipetakan ke 0,1 milimeter. Positif x ada di sebelah kanan; positif y sudah habis.
MM_TEXT	Setiap unit logis dipetakan ke satu piksel perangkat. Positif x ada di sebelah kanan; positif y turun.
MM_TWIPS	Setiap unit logis dipetakan ke satu per dua puluh titik printer (1/1440 inci, juga disebut twip). Positif x ada di sebelah kanan; positif y sudah habis.

Nilai kembali

Jika fungsi berhasil, nilai pengembalian mengidentifikasi mode pemetaan sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Mode MM_TEXT memungkinkan aplikasi untuk bekerja dalam piksel perangkat, yang ukurannya bervariasi dari perangkat ke perangkat.

Mode MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC, dan MM_TWIPS berguna untuk aplikasi yang menggambar di unit yang bermakna secara fisik (seperti inci atau milimeter).

Mode MM_ISOTROPIC memastikan rasio aspek 1:1.

Mode MM_ANISOTROPIC memungkinkan koordinat x dan koordinat y disesuaikan secara independen.

Contoh

Misalnya, lihat Menggunakan Ruang Koordinat dan Transformasi.

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