Struktur DEVMODEA (wingdi.h)
Struktur data DEVMODE berisi informasi tentang inisialisasi dan lingkungan printer atau perangkat tampilan.
Sintaks
typedef struct _devicemodeA {
BYTE dmDeviceName[CCHDEVICENAME];
WORD dmSpecVersion;
WORD dmDriverVersion;
WORD dmSize;
WORD dmDriverExtra;
DWORD dmFields;
union {
struct {
short dmOrientation;
short dmPaperSize;
short dmPaperLength;
short dmPaperWidth;
short dmScale;
short dmCopies;
short dmDefaultSource;
short dmPrintQuality;
} DUMMYSTRUCTNAME;
POINTL dmPosition;
struct {
POINTL dmPosition;
DWORD dmDisplayOrientation;
DWORD dmDisplayFixedOutput;
} DUMMYSTRUCTNAME2;
} DUMMYUNIONNAME;
short dmColor;
short dmDuplex;
short dmYResolution;
short dmTTOption;
short dmCollate;
BYTE dmFormName[CCHFORMNAME];
WORD dmLogPixels;
DWORD dmBitsPerPel;
DWORD dmPelsWidth;
DWORD dmPelsHeight;
union {
DWORD dmDisplayFlags;
DWORD dmNup;
} DUMMYUNIONNAME2;
DWORD dmDisplayFrequency;
DWORD dmICMMethod;
DWORD dmICMIntent;
DWORD dmMediaType;
DWORD dmDitherType;
DWORD dmReserved1;
DWORD dmReserved2;
DWORD dmPanningWidth;
DWORD dmPanningHeight;
} DEVMODEA, *PDEVMODEA, *NPDEVMODEA, *LPDEVMODEA;
Anggota
dmDeviceName[CCHDEVICENAME]
Array karakter yang dihentikan nol yang menentukan nama "ramah" printer atau tampilan; misalnya, "PCL/HP LaserJet" dalam kasus PCL/HP LaserJet. String ini unik di antara driver perangkat. Perhatikan bahwa nama ini dapat dipotong agar pas dalam array dmDeviceName .
dmSpecVersion
Nomor versi spesifikasi data inisialisasi tempat struktur didasarkan. Untuk memastikan versi yang benar digunakan untuk sistem operasi apa pun, gunakan DM_SPECVERSION.
dmDriverVersion
Nomor versi driver yang ditetapkan oleh pengembang driver.
dmSize
Menentukan ukuran, dalam byte, dari struktur DEVMODE , tidak termasuk data khusus driver privat yang mungkin mengikuti anggota publik struktur. Atur anggota ini ke sizeof (DEVMODE) untuk menunjukkan versi struktur DEVMODE yang digunakan.
dmDriverExtra
Berisi jumlah byte data driver pribadi yang mengikuti struktur ini. Jika driver perangkat tidak menggunakan informasi khusus perangkat, atur anggota ini ke nol.
dmFields
Menentukan apakah anggota tertentu dari struktur DEVMODE telah diinisialisasi. Jika anggota diinisialisasi, bit yang sesuai diatur, jika tidak, bit akan jelas. Driver hanya mendukung anggota DEVMODE yang sesuai untuk printer atau teknologi tampilan.
Nilai berikut ditentukan, dan tercantum di sini dengan anggota struktur yang sesuai.
| Nilai | Anggota struktur |
|---|---|
| DM_ORIENTATION | dmOrientation |
| DM_PAPERSIZE | dmPaperSize |
| DM_PAPERLENGTH | dmPaperLength |
| DM_PAPERWIDTH | dmPaperWidth |
| DM_SCALE | dmScale |
| DM_COPIES | dmCopies |
| DM_DEFAULTSOURCE | dmDefaultSource |
| DM_PRINTQUALITY | dmPrintQuality |
| DM_POSITION | dmPosition |
| DM_DISPLAYORIENTATION | dmDisplayOrientation |
| DM_DISPLAYFIXEDOUTPUT | dmDisplayFixedOutput |
| DM_COLOR | dmColor |
| DM_DUPLEX | dmDuplex |
| DM_YRESOLUTION | dmYResolution |
| DM_TTOPTION | dmTTOption |
| DM_COLLATE | dmCollate |
| DM_FORMNAME | dmFormName |
| DM_LOGPIXELS | dmLogPixels |
| DM_BITSPERPEL | dmBitsPerPel |
| DM_PELSWIDTH | dmPelsWidth |
| DM_PELSHEIGHT | dmPelsHeight |
| DM_DISPLAYFLAGS | dmDisplayFlags |
| DM_NUP | dmNup |
| DM_DISPLAYFREQUENCY | dmDisplayFrequency |
| DM_ICMMETHOD | dmICMMethod |
| DM_ICMINTENT | dmICMIntent |
| DM_MEDIATYPE | dmMediaType |
| DM_DITHERTYPE | dmDitherType |
| DM_PANNINGWIDTH | dmPanningWidth |
| DM_PANNINGHEIGHT | dmPanningHeight |
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation
Hanya untuk perangkat printer, pilih orientasi kertas. Anggota ini dapat berupa DMORIENT_PORTRAIT (1) atau DMORIENT_LANDSCAPE (2).
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize
Untuk perangkat printer saja, pilih ukuran kertas yang akan dicetak. Anggota ini dapat diatur ke nol jika panjang dan lebar kertas diatur oleh anggota dmPaperLength dan dmPaperWidth . Jika tidak, anggota dmPaperSize dapat diatur ke nilai spesifik perangkat yang lebih besar dari atau sama dengan DMPAPER_USER atau ke salah satu nilai yang telah ditentukan sebelumnya berikut.
| Nilai | Makna |
|---|---|
| DMPAPER_LETTER | Surat, 8 1/2- dengan 11 inci |
| DMPAPER_LEGAL | Legal, 8 1/2- dengan 14 inci |
| DMPAPER_9X11 | Lembar 9- demi 11 inci |
| DMPAPER_10X11 | Lembar 10- sebesar 11 inci |
| DMPAPER_10X14 | Lembar 10- sebesar 14 inci |
| DMPAPER_15X11 | Lembar 15 demi 11 inci |
| DMPAPER_11X17 | Lembar 11-demi 17 inci |
| DMPAPER_12X11 | Lembar 12-demi-11 inci |
| DMPAPER_A2 | Lembar A2, 420 x 594 milimeter |
| DMPAPER_A3 | Lembar A3, 297- oleh 420 milimeter |
| DMPAPER_A3_EXTRA | A3 Ekstra 322 x 445 milimeter |
| DMPAPER_A3_EXTRA_TRAVERSE | A3 Ekstra Melintang 322 x 445 milimeter |
| DMPAPER_A3_ROTATED | Lembar yang diputar A3, 420- dengan 297 milimeter |
| DMPAPER_A3_TRAVERSE | A3 Melintang 297 x 420 milimeter |
| DMPAPER_A4 | Lembar A4, 210- dengan 297 milimeter |
| DMPAPER_A4_EXTRA | Lembar A4, 9,27 x 12,69 inci |
| DMPAPER_A4_PLUS | A4 Plus 210 x 330 milimeter |
| DMPAPER_A4_ROTATED | Lembar yang diputar A4, 297- dengan 210 milimeter |
| DMPAPER_A4SMALL | Lembar kecil A4, 210- oleh 297 milimeter |
| DMPAPER_A4_TRANSVERSE | A4 Melintang 210 x 297 milimeter |
| DMPAPER_A5 | Lembar A5, 148- dengan 210 milimeter |
| DMPAPER_A5_EXTRA | A5 Ekstra 174 x 235 milimeter |
| DMPAPER_A5_ROTATED | Lembar yang diputar A5, 210- dengan 148 milimeter |
| DMPAPER_A5_TRANSVERSE | A5 Melintang 148 x 210 milimeter |
| DMPAPER_A6 | Lembar A6, 105- dengan 148 milimeter |
| DMPAPER_A6_ROTATED | Lembar yang diputar A6, 148- dengan 105 milimeter |
| DMPAPER_A_PLUS | SuperA/A4 227 x 356 -milimeter |
| DMPAPER_B4 | Lembar B4, 250- dengan 354 milimeter |
| DMPAPER_B4_JIS_ROTATED | Lembar yang diputar B4 (JIS), 364- dengan 257 milimeter |
| DMPAPER_B5 | Lembar B5, 182- dengan kertas 257 milimeter |
| DMPAPER_B5_EXTRA | B5 (ISO) Ekstra 201 x 276 milimeter |
| DMPAPER_B5_JIS_ROTATED | Lembar yang diputar B5 (JIS), 257- dengan 182 milimeter |
| DMPAPER_B6_JIS | Lembar B6 (JIS), 128- dengan 182 milimeter |
| DMPAPER_B6_JIS_ROTATED | Lembar yang diputar B6 (JIS), 182- dengan 128 milimeter |
| DMPAPER_B_PLUS | SuperB/A3 305 x 487 milimeter |
| DMPAPER_CSHEET | Lembar C, 17- dengan 22 inci |
| DMPAPER_DBL_JAPANESE_POSTCARD | Kartu Pos Jepang Ganda, 200- dengan 148 milimeter |
| DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED | Kartu Pos Jepang Ganda Diputar, 148- dengan 200 milimeter |
| DMPAPER_DSHEET | Lembar D, 22- dengan 34 inci |
| DMPAPER_ENV_9 | Amplop #9, 3 7/8- sebesar 8 7/8 inci |
| DMPAPER_ENV_10 | Amplop #10, 4 1/8- dengan 9 1/2 inci |
| DMPAPER_ENV_11 | Amplop #11, 4 1/2- dengan 10 3/8 inci |
| DMPAPER_ENV_12 | Amplop #12, 4 3/4- dengan 11 inci |
| DMPAPER_ENV_14 | Amplop #14, 5- dengan 11 1/2 inci |
| DMPAPER_ENV_C5 | Amplop C5, 162- oleh 229 milimeter |
| DMPAPER_ENV_C3 | Amplop C3, 324- oleh 458 milimeter |
| DMPAPER_ENV_C4 | Amplop C4, 229- oleh 324 milimeter |
| DMPAPER_ENV_C6 | Amplop C6, 114- oleh 162 milimeter |
| DMPAPER_ENV_C65 | Amplop C65, 114- oleh 229 milimeter |
| DMPAPER_ENV_B4 | Amplop B4, 250- oleh 353 milimeter |
| DMPAPER_ENV_B5 | Amplop B5, 176- oleh 250 milimeter |
| DMPAPER_ENV_B6 | Amplop B6, 176- oleh 125 milimeter |
| DMPAPER_ENV_DL | Amplop DL, 110- oleh 220 milimeter |
| DMPAPER_ENV_INVITE | Amplop Undang 220 x 220 mm |
| DMPAPER_ENV_ITALY | Amplop Italia, 110- oleh 230 milimeter |
| DMPAPER_ENV_MONARCH | Amplop Monarki, 3 7/8- dengan 7 1/2 inci |
| DMPAPER_ENV_PERSONAL | Amplop 6 3/4, 3 5/8- dengan 6 1/2 inci |
| DMPAPER_ESHEET | E Lembar, 34- sebesar 44 inci |
| DMPAPER_EXECUTIVE | Eksekutif, 7 1/4- dengan 10 1/2 inci |
| DMPAPER_FANFOLD_US | US Std Fanfold, 14 7/8- dengan 11 inci |
| DMPAPER_FANFOLD_STD_GERMAN | German Std Fanfold, 8 1/2- dengan 12 inci |
| DMPAPER_FANFOLD_LGL_GERMAN | German Legal Fanfold, 8 - oleh 13 inci |
| DMPAPER_FOLIO | Folio, 8 1/2- dengan kertas 13 inci |
| DMPAPER_ISO_B4 | Kertas B4 (ISO) 250- dengan 353 milimeter |
| DMPAPER_JAPANESE_POSTCARD | Kartu Pos Jepang, 100- oleh 148 milimeter |
| DMPAPER_JAPANESE_POSTCARD_ROTATED | Kartu Pos Jepang Diputar, 148- oleh 100 milimeter |
| DMPAPER_JENV_CHOU3 | Amplop Jepang Chou #3 |
| DMPAPER_JENV_CHOU3_ROTATED | Amplop Jepang Chou #3 Diputar |
| DMPAPER_JENV_CHOU4 | Amplop Jepang Chou #4 |
| DMPAPER_JENV_CHOU4_ROTATED | Amplop Jepang Chou #4 Diputar |
| DMPAPER_JENV_KAKU2 | Amplop Jepang Kaku #2 |
| DMPAPER_JENV_KAKU2_ROTATED | Amplop Jepang Kaku #2 Diputar |
| DMPAPER_JENV_KAKU3 | Amplop Jepang Kaku #3 |
| DMPAPER_JENV_KAKU3_ROTATED | Amplop Jepang Kaku #3 Diputar |
| DMPAPER_JENV_YOU4 | Amplop Jepang Anda #4 |
| DMPAPER_JENV_YOU4_ROTATED | Amplop Jepang Anda #4 Diputar |
| DMPAPER_LAST | DMPAPER_PENV_10_ROTATED |
| DMPAPER_LEDGER | Ledger, 17- dengan 11 inci |
| DMPAPER_LEGAL_EXTRA | Legal Ekstra 9 1/2 x 15 inci. |
| DMPAPER_LETTER_EXTRA | Huruf Ekstra 9 1/2 x 12 inci. |
| DMPAPER_LETTER_EXTRA_TRANSVERSE | Letter Extra Transverse 9 1/2 x 12 inci. |
| DMPAPER_LETTER_ROTATED | Letter Rotated 11 by 8 1/2 inci |
| DMPAPER_LETTERSMALL | Letter Small, 8 1/2- by 11 inci |
| DMPAPER_LETTER_TRANSVERSE | Letter Transverse 8 1/2 x 11 inci |
| DMPAPER_NOTE | Catatan, 8 1/2- dengan 11 inci |
| DMPAPER_P16K | PRC 16K, 146- oleh 215 milimeter |
| DMPAPER_P16K_ROTATED | PRC 16K Diputar, 215- oleh 146 milimeter |
| DMPAPER_P32K | PRC 32K, 97- oleh 151 milimeter |
| DMPAPER_P32K_ROTATED | PRC 32K Diputar, 151- oleh 97 milimeter |
| DMPAPER_P32KBIG | PRC 32K(Big) 97- oleh 151 milimeter |
| DMPAPER_P32KBIG_ROTATED | PRC 32K(Besar) Diputar, 151- oleh 97 milimeter |
| DMPAPER_PENV_1 | Amplop PRC #1, 102- oleh 165 milimeter |
| DMPAPER_PENV_1_ROTATED | Amplop PRC #1 Diputar, 165- oleh 102 milimeter |
| DMPAPER_PENV_2 | Amplop PRC #2, 102- oleh 176 milimeter |
| DMPAPER_PENV_2_ROTATED | Amplop PRC #2 Diputar, 176- oleh 102 milimeter |
| DMPAPER_PENV_3 | Amplop PRC #3, 125- oleh 176 milimeter |
| DMPAPER_PENV_3_ROTATED | Amplop PRC #3 Diputar, 176- oleh 125 milimeter |
| DMPAPER_PENV_4 | Amplop PRC #4, 110- oleh 208 milimeter |
| DMPAPER_PENV_4_ROTATED | Amplop PRC #4 Diputar, 208- oleh 110 milimeter |
| DMPAPER_PENV_5 | Amplop PRC #5, 110- oleh 220 milimeter |
| DMPAPER_PENV_5_ROTATED | Amplop PRC #5 Diputar, 220- oleh 110 milimeter |
| DMPAPER_PENV_6 | Amplop PRC #6, 120- oleh 230 milimeter |
| DMPAPER_PENV_6_ROTATED | Amplop PRC #6 Diputar, 230- oleh 120 milimeter |
| DMPAPER_PENV_7 | Amplop PRC #7, 160- oleh 230 milimeter |
| DMPAPER_PENV_7_ROTATED | Amplop PRC #7 Diputar, 230- oleh 160 milimeter |
| DMPAPER_PENV_8 | Amplop PRC #8, 120- oleh 309 milimeter |
| DMPAPER_PENV_8_ROTATED | Amplop PRC #8 Diputar, 309- oleh 120 milimeter |
| DMPAPER_PENV_9 | Amplop PRC #9, 229- oleh 324 milimeter |
| DMPAPER_PENV_9_ROTATED | Amplop PRC #9 Diputar, 324- oleh 229 milimeter |
| DMPAPER_PENV_10 | Amplop PRC #10, 324- oleh 458 milimeter |
| DMPAPER_PENV_10_ROTATED | Amplop PRC #10 Diputar, 458- oleh 324 milimeter |
| DMPAPER_QUARTO | Quarto, 215- dengan kertas 275 milimeter |
| DMPAPER_STATEMENT | Pernyataan, 5 1/2- sebesar 8 1/2 inci |
| DMPAPER_TABLOID | Tabloid, 11- dengan 17 inci |
| DMPAPER_TABLOID_EXTRA | Tabloid, 11,69 x 18 inci |
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength
Hanya untuk perangkat printer, ambil alih panjang kertas yang ditentukan oleh anggota dmPaperSize , baik untuk ukuran kertas kustom atau untuk perangkat seperti printer dot-matrix yang dapat mencetak pada halaman dengan panjang arbitrer. Nilai-nilai ini, bersama dengan semua nilai lain dalam struktur ini yang menentukan panjang fisik, berada dalam persepuluh milimeter.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth
Hanya untuk perangkat printer, ambil alih lebar kertas yang ditentukan oleh anggota dmPaperSize .
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale
Menentukan faktor di mana output cetak akan diskalakan. Ukuran halaman yang jelas diskalakan dari ukuran halaman fisik dengan faktor dmScale /100. Misalnya, halaman berukuran huruf dengan nilai dmScale 50 akan berisi data sebanyak halaman 17- dengan 22 inci karena teks output dan grafik akan menjadi setengah dari tinggi dan lebar aslinya.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies
Memilih jumlah salinan yang dicetak jika perangkat mendukung salinan beberapa halaman.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource
Menentukan sumber kertas. Untuk mengambil daftar sumber kertas yang tersedia untuk printer, gunakan fungsi DeviceCapabilities dengan bendera DC_BINS.
Anggota ini bisa menjadi salah satu nilai berikut, atau bisa menjadi nilai khusus perangkat yang lebih besar dari atau sama dengan DMBIN_USER.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality
Menentukan resolusi printer. Ada empat nilai independen perangkat yang telah ditentukan sebelumnya:
Jika nilai positif ditentukan, nilai tersebut menentukan jumlah titik per inci (DPI) dan karenanya bergantung pada perangkat.
DUMMYUNIONNAME.dmPosition
DUMMYUNIONNAME.DUMMYSTRUCTNAME2
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition
Hanya untuk perangkat tampilan, struktur POINTL yang menunjukkan koordinat posisi perangkat tampilan dalam referensi ke area desktop. Perangkat tampilan utama selalu terletak pada koordinat (0,0).
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation
Hanya untuk perangkat tampilan, orientasi di mana gambar harus disajikan. Jika DM_DISPLAYORIENTATION tidak diatur, anggota ini harus nol. Jika DM_DISPLAYORIENTATION diatur, anggota ini harus menjadi salah satu nilai berikut
| Nilai | Makna |
|---|---|
| DMDO_DEFAULT | Orientasi tampilan adalah orientasi alami perangkat tampilan; harus digunakan sebagai default. |
| DMDO_90 | Orientasi tampilan diputar 90 derajat (diukur searah jarang) dari DMDO_DEFAULT. |
| DMDO_180 | Orientasi tampilan diputar 180 derajat (diukur searah jarang) dari DMDO_DEFAULT. |
| DMDO_270 | Orientasi tampilan diputar 270 derajat (diukur searah jarang) dari DMDO_DEFAULT. |
Untuk menentukan apakah orientasi tampilan adalah orientasi potret atau lanskap, periksa rasio dmPelsWidth ke dmPelsHeight.
Windows 2000: Tidak didukung.
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput
Hanya untuk perangkat tampilan resolusi tetap, bagaimana tampilan menyajikan mode resolusi rendah pada tampilan resolusi lebih tinggi. Misalnya, jika resolusi perangkat tampilan diperbaiki pada 1024 x 768 piksel tetapi modenya diatur ke 640 x 480 piksel, perangkat dapat menampilkan gambar 640 x 480 di suatu tempat di interior ruang layar 1024 x 768 atau meregangkan gambar 640 x 480 untuk mengisi ruang layar yang lebih besar. Jika DM_DISPLAYFIXEDOUTPUT tidak diatur, anggota ini harus nol. Jika DM_DISPLAYFIXEDOUTPUT diatur, anggota ini harus menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
| DMDFO_DEFAULT | Pengaturan default tampilan. |
| DMDFO_CENTER | Gambar resolusi rendah berpusat di ruang layar yang lebih besar. |
| DMDFO_STRETCH | Gambar resolusi rendah direntangkan untuk mengisi ruang layar yang lebih besar. |
Windows 2000: Tidak didukung.
dmColor
Beralih antara warna dan monokrom pada printer warna. Berikut ini adalah nilai yang mungkin:
- DMCOLOR_COLOR
- DMCOLOR_MONOCHROME
dmDuplex
Memilih pencetakan dupleks atau dua sisi untuk printer yang mampu mencetak dupleks. Berikut ini adalah nilai yang mungkin.
| Nilai | Makna |
|---|---|
| DMDUP_SIMPLEX | Pencetakan normal (nondupleks). |
| DMDUP_HORIZONTAL | Pengikatan tepi pendek, yaitu, tepi panjang halaman adalah horizontal. |
| DMDUP_VERTICAL | Pengikatan tepi panjang, yaitu, tepi panjang halaman vertikal. |
dmYResolution
Menentukan resolusi y, dalam titik per inci, dari printer. Jika printer menginisialisasi anggota ini, anggota dmPrintQuality menentukan resolusi x, dalam titik per inci, dari printer.
dmTTOption
Menentukan bagaimana font TrueType harus dicetak. Anggota ini bisa menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
| DMTT_BITMAP | Mencetak font TrueType sebagai grafik. Ini adalah tindakan default untuk printer dot-matrix. |
| DMTT_DOWNLOAD | Mengunduh font TrueType sebagai font lunak. Ini adalah tindakan default untuk printer Hewlett-Packard yang menggunakan Printer Control Language (PCL). |
| DMTT_DOWNLOAD_OUTLINE | Mengunduh font TrueType sebagai kerangka font lunak. |
| DMTT_SUBDEV | Mengganti font perangkat untuk font TrueType. Ini adalah tindakan default untuk printer PostScript. |
dmCollate
Menentukan apakah kolase harus digunakan saat mencetak beberapa salinan. (Anggota ini diabaikan kecuali driver printer menunjukkan dukungan untuk kolae dengan mengatur anggota dmFields ke DM_COLLATE.) Anggota ini bisa menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
| DMCOLLATE_TRUE | Susun saat mencetak beberapa salinan. |
| DMCOLLATE_FALSE | Jangan menyusun ketika mencetak beberapa salinan. |
dmFormName[CCHFORMNAME]
Array karakter nol yang dihentikan yang menentukan nama formulir yang akan digunakan; misalnya, "Letter" atau "Legal". Sekumpulan nama lengkap dapat diambil dengan menggunakan fungsi EnumForms .
dmLogPixels
Jumlah piksel per inci logis. Pengandar pencetak tidak menggunakan anggota ini.
dmBitsPerPel
Menentukan resolusi warna, dalam bit per piksel, dari perangkat tampilan (misalnya: 4 bit untuk 16 warna, 8 bit untuk 256 warna, atau 16 bit untuk 65.536 warna). Driver tampilan menggunakan anggota ini, misalnya, dalam fungsi ChangeDisplaySettings . Pengandar pencetak tidak menggunakan anggota ini.
dmPelsWidth
Menentukan lebar, dalam piksel, dari permukaan perangkat yang terlihat. Driver tampilan menggunakan anggota ini, misalnya, dalam fungsi ChangeDisplaySettings . Pengandar pencetak tidak menggunakan anggota ini.
dmPelsHeight
Menentukan tinggi, dalam piksel, dari permukaan perangkat yang terlihat. Driver tampilan menggunakan anggota ini, misalnya, dalam fungsi ChangeDisplaySettings . Pengandar pencetak tidak menggunakan anggota ini.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.dmDisplayFlags
Menentukan mode tampilan perangkat. Anggota ini bisa menjadi kombinasi dari nilai berikut.
| Nilai | Makna |
|---|---|
| DM_GRAYSCALE | Menentukan bahwa tampilan adalah perangkat nonwarna. Jika bendera ini tidak diatur, warna diasumsikan. |
| DM_INTERLACED | Menentukan bahwa mode tampilan terjalin. Jika bendera tidak diatur, maka tidak terinterlaced akan diasumsikan. |
Driver tampilan menggunakan anggota ini, misalnya, dalam fungsi ChangeDisplaySettings . Pengandar pencetak tidak menggunakan anggota ini.
DUMMYUNIONNAME2.dmNup
Menentukan di mana NUP dilakukan. Ini bisa menjadi salah satu dari berikut ini.
| Nilai | Makna |
|---|---|
| DMNUP_SYSTEM | Penampung cetak melakukan NUP. |
| DMNUP_ONEUP | Aplikasi melakukan NUP. |
dmDisplayFrequency
Menentukan frekuensi, dalam hertz (siklus per detik), dari perangkat tampilan dalam mode tertentu. Nilai ini juga dikenal sebagai laju refresh vertikal perangkat tampilan. Driver tampilan menggunakan anggota ini. Ini digunakan, misalnya, dalam fungsi ChangeDisplaySettings . Pengandar pencetak tidak menggunakan anggota ini.
Saat Anda memanggil fungsi EnumDisplaySettings , anggota dmDisplayFrequency dapat kembali dengan nilai 0 atau 1. Nilai-nilai ini mewakili laju refresh default perangkat keras tampilan. Laju default ini biasanya diatur oleh sakelar pada kartu tampilan atau motherboard komputer, atau oleh program konfigurasi yang tidak menggunakan fungsi tampilan seperti ChangeDisplaySettings.
dmICMMethod
Menentukan bagaimana ICM ditangani. Untuk aplikasi non-ICM, anggota ini menentukan apakah ICM diaktifkan atau dinonaktifkan. Untuk aplikasi ICM, sistem memeriksa anggota ini untuk menentukan cara menangani dukungan ICM. Anggota ini bisa menjadi salah satu nilai yang telah ditentukan sebelumnya berikut, atau nilai yang ditentukan driver lebih besar dari atau sama dengan nilai DMICMMETHOD_USER.
| Nilai | Makna |
|---|---|
| DMICMMETHOD_NONE | Menentukan bahwa ICM dinonaktifkan. |
| DMICMMETHOD_SYSTEM | Menentukan bahwa ICM ditangani oleh Windows. |
| DMICMMETHOD_DRIVER | Menentukan bahwa ICM ditangani oleh driver perangkat. |
| DMICMMETHOD_DEVICE | Menentukan bahwa ICM ditangani oleh perangkat tujuan. |
Pengandar pencetak harus menyediakan antarmuka pengguna untuk menyetel anggota ini. Sebagian besar pengandar pencetak hanya mendukung nilai DMICMMETHOD_SYSTEM atau DMICMMETHOD_NONE. Driver untuk printer PostScript mendukung semua nilai.
dmICMIntent
Menentukan metode pencocokan warna, atau niat mana, yang harus digunakan secara default. Anggota ini terutama untuk aplikasi non-ICM. Aplikasi ICM dapat menetapkan niat dengan menggunakan fungsi ICM. Anggota ini dapat menjadi salah satu nilai yang telah ditentukan sebelumnya berikut, atau nilai yang ditentukan driver yang lebih besar dari atau sama dengan nilai DMICM_USER.
| Nilai | Makna |
|---|---|
| DMICM_ABS_COLORIMETRIC | Pencocokan warna harus dioptimalkan agar sesuai dengan warna persis yang diminta tanpa pemetaan titik putih. Nilai ini paling tepat untuk digunakan dengan pemeriksaan. |
| DMICM_COLORIMETRIC | Pencocokan warna harus dioptimalkan agar sesuai dengan warna persis yang diminta. Nilai ini paling tepat untuk digunakan dengan logo bisnis atau gambar lain ketika kecocokan warna yang tepat diinginkan. |
| DMICM_CONTRAST | Pencocokan warna harus dioptimalkan untuk kontras warna. Nilai ini adalah pilihan yang paling tepat untuk gambar yang dipindai atau difoto saat dithering diinginkan. |
| DMICM_SATURATE | Pencocokan warna harus dioptimalkan untuk saturasi warna. Nilai ini adalah pilihan yang paling tepat untuk grafik bisnis saat menambungkan tidak diinginkan. |
dmMediaType
Menentukan tipe media yang sedang dicetak. Anggota dapat menjadi salah satu nilai yang telah ditentukan sebelumnya berikut, atau nilai yang ditentukan driver lebih besar dari atau sama dengan nilai DMMEDIA_USER.
| Nilai | Makna |
|---|---|
| DMMEDIA_STANDARD | Kertas biasa. |
| DMMEDIA_GLOSSY | Kertas glosarium. |
| DMMEDIA_TRANSPARENCY | Film transparan. |
Untuk mengambil daftar jenis media yang tersedia untuk printer, gunakan fungsi DeviceCapabilities dengan bendera DC_MEDIATYPES.
dmDitherType
Menentukan bagaimana dithering harus dilakukan. Anggota dapat menjadi salah satu nilai yang telah ditentukan sebelumnya berikut, atau nilai yang ditentukan driver lebih besar dari atau sama dengan nilai DMDITHER_USER.
| Nilai | Makna |
|---|---|
| DMDITHER_NONE | Tidak ada dithering. |
| DMDITHER_COARSE | Dithering dengan kuas kasar. |
| DMDITHER_FINE | Dithering dengan kuas halus. |
| DMDITHER_LINEART | Line art dithering, metode khusus dithering yang menghasilkan perbatasan yang terdefinisi dengan baik antara penskalan hitam, putih, dan abu-abu. Tidak cocok untuk gambar yang mencakup kelulusan berkelanjutan dalam intensitas dan rona, seperti foto yang dipindai. |
| DMDITHER_GRAYSCALE | Perangkat melakukan penskalakan abu-abu. |
dmReserved1
Tidak digunakan; harus nol.
dmReserved2
Tidak digunakan; harus nol.
dmPanningWidth
Anggota ini harus nol.
dmPanningHeight
Anggota ini harus nol.
Keterangan
Data pribadi driver perangkat mengikuti bagian publik dari struktur DEVMODE . Ukuran data publik dapat bervariasi untuk versi struktur yang berbeda. Anggota dmSize menentukan jumlah byte data publik, dan anggota dmDriverExtra menentukan jumlah byte data privat.
Catatan
Header wingdi.h mendefinisikan DEVMODE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | wingdi.h (sertakan Windows.h) |