Struttura DEVMODEA (wingdi.h)
La struttura dei dati DEVMODE contiene informazioni sull'inizializzazione e sull'ambiente di una stampante o di un dispositivo di visualizzazione.
Sintassi
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;
Members
dmDeviceName[CCHDEVICENAME]
Matrice di caratteri con terminazione zero che specifica il nome "descrittivo" della stampante o della visualizzazione; Ad esempio, "PCL/HP LaserJet" nel caso di PCL/HP LaserJet. Questa stringa è univoca tra i driver di dispositivo. Si noti che questo nome può essere troncato per adattarsi alla matrice dmDeviceName .
dmSpecVersion
Numero di versione della specifica dei dati di inizializzazione su cui si basa la struttura. Per assicurarsi che la versione corretta venga usata per qualsiasi sistema operativo, usare DM_SPECVERSION.
dmDriverVersion
Numero di versione del driver assegnato dallo sviluppatore del driver.
dmSize
Specifica le dimensioni, in byte, della struttura DEVMODE , senza includere dati specifici del driver privato che potrebbero seguire i membri pubblici della struttura. Impostare questo membro su sizeof (DEVMODE) per indicare la versione della struttura DEVMODE in uso.
dmDriverExtra
Contiene il numero di byte di dati del driver privato che seguono questa struttura. Se un driver di dispositivo non usa informazioni specifiche del dispositivo, impostare questo membro su zero.
dmFields
Specifica se alcuni membri della struttura DEVMODE sono stati inizializzati. Se un membro viene inizializzato, viene impostato il bit corrispondente; in caso contrario, il bit è chiaro. Un driver supporta solo i membri DEVMODE appropriati per la stampante o la tecnologia di visualizzazione.
I valori seguenti sono definiti e sono elencati qui con i membri della struttura corrispondenti.
| Valore | Membro struttura |
|---|---|
| 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
Solo per i dispositivi della stampante, seleziona l'orientamento della carta. Questo membro può essere DMORIENT_PORTRAIT (1) o DMORIENT_LANDSCAPE (2).
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize
Solo per i dispositivi della stampante, seleziona le dimensioni della carta su cui stampare. Questo membro può essere impostato su zero se la lunghezza e la larghezza del foglio sono entrambe impostate dai membri dmPaperLength e dmPaperWidth . In caso contrario, il membro dmPaperSize può essere impostato su un valore specifico del dispositivo maggiore o uguale a DMPAPER_USER o a uno dei valori predefiniti seguenti.
| Valore | Significato |
|---|---|
| DMPAPER_LETTER | Lettera, 8 1/2- 11 pollici |
| DMPAPER_LEGAL | Legale, 8 1/2- 14 pollici |
| DMPAPER_9X11 | Foglio da 9 a 11 pollici |
| DMPAPER_10X11 | Foglio da 10 a 11 pollici |
| DMPAPER_10X14 | Foglio da 10 a 14 pollici |
| DMPAPER_15X11 | Foglio da 15 a 11 pollici |
| DMPAPER_11X17 | Foglio da 11 a 17 pollici |
| DMPAPER_12X11 | Foglio da 12 a 11 pollici |
| DMPAPER_A2 | Foglio A2, 420 x 594 millimetri |
| DMPAPER_A3 | Foglio A3, da 297 a 420 millimetri |
| DMPAPER_A3_EXTRA | A3 Extra 322 x 445 millimetri |
| DMPAPER_A3_EXTRA_TRAVERSE | A3 Extra Transverse 322 x 445 millimetri |
| DMPAPER_A3_ROTATED | A3 foglio ruotato, 420- per 297 millimetri |
| DMPAPER_A3_TRAVERSE | A3 Transverse 297 x 420 millimetri |
| DMPAPER_A4 | Foglio A4, da 210 a 297 millimetri |
| DMPAPER_A4_EXTRA | Foglio A4, 9,27 x 12,69 pollici |
| DMPAPER_A4_PLUS | A4 Plus 210 x 330 millimetri |
| DMPAPER_A4_ROTATED | A4 foglio ruotato, 297- per 210 millimetri |
| DMPAPER_A4SMALL | A4 piccolo foglio, 210- da 297 millimetri |
| DMPAPER_A4_TRANSVERSE | A4 Transverse 210 x 297 millimetri |
| DMPAPER_A5 | Foglio A5, 148- per 210 millimetri |
| DMPAPER_A5_EXTRA | A5 Extra 174 x 235 millimetri |
| DMPAPER_A5_ROTATED | A5 foglio ruotato, 210- per 148 millimetri |
| DMPAPER_A5_TRANSVERSE | A5 Transverse 148 x 210 millimetri |
| DMPAPER_A6 | Foglio A6, da 105 a 148 millimetri |
| DMPAPER_A6_ROTATED | Foglio ruotato A6, 148- da 105 millimetri |
| DMPAPER_A_PLUS | SuperA/A4 227 x 356 millimetri |
| DMPAPER_B4 | Foglio B4, da 250 a 354 millimetri |
| DMPAPER_B4_JIS_ROTATED | Foglio ruotato B4 (JIS), 364- per 257 millimetri |
| DMPAPER_B5 | Foglio B5, carta da 182 a 257 millimetri |
| DMPAPER_B5_EXTRA | B5 (ISO) Extra 201 x 276 millimetri |
| DMPAPER_B5_JIS_ROTATED | Foglio ruotato B5 (JIS), 257- da 182 millimetri |
| DMPAPER_B6_JIS | Foglio B6 (JIS), 128- da 182 millimetri |
| DMPAPER_B6_JIS_ROTATED | Foglio ruotato B6 (JIS), 182- per 128 millimetri |
| DMPAPER_B_PLUS | SuperB/A3 305 x 487 millimetri |
| DMPAPER_CSHEET | Foglio C, da 17 a 22 pollici |
| DMPAPER_DBL_JAPANESE_POSTCARD | Cartolina giapponese doppia, da 200 a 148 millimetri |
| DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED | Doppia cartolina giapponese ruotata, 148- di 200 millimetri |
| DMPAPER_DSHEET | D Foglio, da 22 a 34 pollici |
| DMPAPER_ENV_9 | Busta n. 9, 3 7/8- per 8 7/8 pollici |
| DMPAPER_ENV_10 | Busta #10, 4 1/8- 9 1/2 pollici |
| DMPAPER_ENV_11 | Busta n. 11, 4 1/2- 10 3/8 pollici |
| DMPAPER_ENV_12 | Busta n. 12, 4 3/4 per 11 pollici |
| DMPAPER_ENV_14 | Busta n. 14, da 5 a 11 1/2 pollici |
| DMPAPER_ENV_C5 | Busta C5, da 162 a 229 millimetri |
| DMPAPER_ENV_C3 | Busta C3, da 324 a 458 millimetri |
| DMPAPER_ENV_C4 | Busta C4, 229- per 324 millimetri |
| DMPAPER_ENV_C6 | Busta C6, da 114 a 162 millimetri |
| DMPAPER_ENV_C65 | Busta C65, da 114 a 229 millimetri |
| DMPAPER_ENV_B4 | Busta B4, da 250 a 353 millimetri |
| DMPAPER_ENV_B5 | Busta B5, da 176 a 250 millimetri |
| DMPAPER_ENV_B6 | Busta B6, 176- da 125 millimetri |
| DMPAPER_ENV_DL | Busta DL, 110- per 220 millimetri |
| DMPAPER_ENV_INVITE | Invito busta 220 x 220 mm |
| DMPAPER_ENV_ITALY | Busta Italia, 110- per 230 millimetri |
| DMPAPER_ENV_MONARCH | Busta monarcha, 3 7/8 per 7 1/2 pollici |
| DMPAPER_ENV_PERSONAL | 6 3/4 Busta, 3 5/8 per 6 1/2 pollici |
| DMPAPER_ESHEET | Foglio E, 34- da 44 pollici |
| DMPAPER_EXECUTIVE | Executive, 7 1/4- da 10 1/2 pollici |
| DMPAPER_FANFOLD_US | Us Std Fanfold, 14 7/8 per 11 pollici |
| DMPAPER_FANFOLD_STD_GERMAN | Fanfold tedesco Std, 8 1/2- da 12 pollici |
| DMPAPER_FANFOLD_LGL_GERMAN | Fanfold legale tedesco, 8 - da 13 pollici |
| DMPAPER_FOLIO | Folio, 8 1/2- da 13 pollici |
| DMPAPER_ISO_B4 | B4 (ISO) da 250 a 353 millimetri di carta |
| DMPAPER_JAPANESE_POSTCARD | Cartolina giapponese, da 100 a 148 millimetri |
| DMPAPER_JAPANESE_POSTCARD_ROTATED | Cartolina giapponese ruotata, da 148 a 100 millimetri |
| DMPAPER_JENV_CHOU3 | Busta giapponese Chou #3 |
| DMPAPER_JENV_CHOU3_ROTATED | Busta giapponese Chou #3 Ruotata |
| DMPAPER_JENV_CHOU4 | Busta giapponese Chou #4 |
| DMPAPER_JENV_CHOU4_ROTATED | Busta giapponese Chou #4 Ruotata |
| DMPAPER_JENV_KAKU2 | Busta giapponese Kaku #2 |
| DMPAPER_JENV_KAKU2_ROTATED | Busta giapponese Kaku #2 Ruotata |
| DMPAPER_JENV_KAKU3 | Busta giapponese Kaku #3 |
| DMPAPER_JENV_KAKU3_ROTATED | Busta giapponese Kaku #3 Ruotata |
| DMPAPER_JENV_YOU4 | Busta giapponese #4 |
| DMPAPER_JENV_YOU4_ROTATED | Busta giapponese 4 ruotata |
| DMPAPER_LAST | DMPAPER_PENV_10_ROTATED |
| DMPAPER_LEDGER | Ledger, 17- da 11 pollici |
| DMPAPER_LEGAL_EXTRA | Legale Extra 9 1/2 x 15 pollici. |
| DMPAPER_LETTER_EXTRA | Lettera Extra 9 1/2 x 12 pollici. |
| DMPAPER_LETTER_EXTRA_TRANSVERSE | Lettera Extra Transverse 9 1/2 x 12 pollici. |
| DMPAPER_LETTER_ROTATED | Lettera ruotata da 11 a 8 1/2 pollici |
| DMPAPER_LETTERSMALL | Lettera piccola, 8 1/2- per 11 pollici |
| DMPAPER_LETTER_TRANSVERSE | Lettera trasversa 8 1/2 x 11 pollici |
| DMPAPER_NOTE | Nota, da 8 1/2 a 11 pollici |
| DMPAPER_P16K | PRC 16K, 146- da 215 millimetri |
| DMPAPER_P16K_ROTATED | PRC 16K Ruotato, 215- da 146 millimetri |
| DMPAPER_P32K | PRC 32K, 97 per 151 millimetri |
| DMPAPER_P32K_ROTATED | PRC 32K Ruotato, 151- per 97 millimetri |
| DMPAPER_P32KBIG | PRC 32K(Big) 97- da 151 millimetri |
| DMPAPER_P32KBIG_ROTATED | PRC 32K(Big) Ruotato, 151- da 97 millimetri |
| DMPAPER_PENV_1 | Busta PRC #1, 102- per 165 millimetri |
| DMPAPER_PENV_1_ROTATED | Busta PRC #1 Ruotata, 165- per 102 millimetri |
| DMPAPER_PENV_2 | Busta PRC #2, 102- per 176 millimetri |
| DMPAPER_PENV_2_ROTATED | Busta PRC #2 Ruotata, 176- da 102 millimetri |
| DMPAPER_PENV_3 | Busta PRC #3, 125- per 176 millimetri |
| DMPAPER_PENV_3_ROTATED | Busta PRC #3 Ruotata, 176- da 125 millimetri |
| DMPAPER_PENV_4 | Busta PRC #4, 110- da 208 millimetri |
| DMPAPER_PENV_4_ROTATED | Busta PRC #4 Ruotata, 208- da 110 millimetri |
| DMPAPER_PENV_5 | Busta PRC #5, 110- per 220 millimetri |
| DMPAPER_PENV_5_ROTATED | Busta PRC #5 Ruotata, 220- per 110 millimetri |
| DMPAPER_PENV_6 | Busta PRC #6, 120- per 230 millimetri |
| DMPAPER_PENV_6_ROTATED | Busta PRC #6 Ruotata, 230- per 120 millimetri |
| DMPAPER_PENV_7 | Busta PRC #7, 160- per 230 millimetri |
| DMPAPER_PENV_7_ROTATED | Busta PRC #7 Ruotata, 230- per 160 millimetri |
| DMPAPER_PENV_8 | Busta PRC n. 8, da 120 a 309 millimetri |
| DMPAPER_PENV_8_ROTATED | Busta PRC n. 8 ruotata, 309- di 120 millimetri |
| DMPAPER_PENV_9 | Busta PRC 9, 229- per 324 millimetri |
| DMPAPER_PENV_9_ROTATED | Busta PRC n. 9 ruotata, da 324 a 229 millimetri |
| DMPAPER_PENV_10 | Busta PRC 10, 324- by 458 millimetri |
| DMPAPER_PENV_10_ROTATED | Busta PRC n. 10 ruotata, da 458 a 324 millimetri |
| DMPAPER_QUARTO | Quarto, carta da 215 millimetri a 275 millimetri |
| DMPAPER_STATEMENT | Istruzione, 5 1/2- per 8 1/2 pollici |
| DMPAPER_TABLOID | Tabloid, da 11 a 17 pollici |
| DMPAPER_TABLOID_EXTRA | Tabloid, 11,69 x 18 pollici |
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength
Solo per i dispositivi della stampante, esegue l'override della lunghezza del foglio specificato dal membro dmPaperSize , sia per i formati di carta personalizzati che per i dispositivi quali stampanti a matrice di punti che possono stampare su una pagina di lunghezza arbitraria. Questi valori, insieme a tutti gli altri valori in questa struttura che specificano una lunghezza fisica, sono in decimi di millimetri.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth
Solo per i dispositivi della stampante, esegue l'override della larghezza del foglio specificato dal membro dmPaperSize .
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale
Specifica il fattore in base al quale deve essere ridimensionato l'output stampato. Le dimensioni apparenti della pagina vengono ridimensionate rispetto alle dimensioni fisiche della pagina in base a un fattore dmScale /100. Ad esempio, una pagina di dimensioni lettera con un valore dmScale pari a 50 conterrà la quantità di dati pari a 17-by-22 pollici, perché il testo di output e la grafica sarebbero la metà dell'altezza e della larghezza originali.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies
Seleziona il numero di copie stampate se il dispositivo supporta copie a più pagine.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource
Specifica l'origine della carta. Per recuperare un elenco delle fonti di carta disponibili per una stampante, utilizzare la funzione DeviceCapabilities con il flag DC_BINS.
Questo membro può essere uno dei valori seguenti oppure può essere un valore specifico del dispositivo maggiore o uguale a DMBIN_USER.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality
Specifica la risoluzione della stampante. Esistono quattro valori predefiniti indipendenti dal dispositivo:
Se viene specificato un valore positivo, specifica il numero di punti per pollice (DPI) ed è quindi dipendente dal dispositivo.
DUMMYUNIONNAME.dmPosition
DUMMYUNIONNAME.DUMMYSTRUCTNAME2
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition
Solo per i dispositivi di visualizzazione, una struttura POINTL che indica le coordinate posizionali del dispositivo di visualizzazione in riferimento all'area desktop. Il dispositivo di visualizzazione primario si trova sempre in corrispondenza delle coordinate (0,0).
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation
Solo per i dispositivi di visualizzazione, l'orientamento in corrispondenza del quale devono essere presentate le immagini. Se DM_DISPLAYORIENTATION non è impostato, questo membro deve essere zero. Se DM_DISPLAYORIENTATION è impostato, questo membro deve essere uno dei valori seguenti
| Valore | Significato |
|---|---|
| DMDO_DEFAULT | L'orientamento dello schermo è l'orientamento naturale del dispositivo di visualizzazione; deve essere usato come impostazione predefinita. |
| DMDO_90 | L'orientamento dello schermo viene ruotato di 90 gradi (misurata in senso orario) da DMDO_DEFAULT. |
| DMDO_180 | L'orientamento dello schermo viene ruotato di 180 gradi (misurata in senso orario) da DMDO_DEFAULT. |
| DMDO_270 | L'orientamento dello schermo viene ruotato di 270 gradi (misurata in senso orario) da DMDO_DEFAULT. |
Per determinare se l'orientamento dello schermo è verticale o orizzontale, controllare il rapporto tra dmPelsWidth e dmPelsHeight.
Windows 2000: Non supportato.
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput
Solo per i dispositivi di visualizzazione a risoluzione fissa, il modo in cui lo schermo presenta una modalità a bassa risoluzione su uno schermo con risoluzione superiore. Ad esempio, se la risoluzione di un dispositivo di visualizzazione è fissa a 1024 x 768 pixel, ma la modalità è impostata su 640 x 480 pixel, il dispositivo può visualizzare un'immagine 640 x 480 in una posizione interna dello spazio dello schermo 1024 x 768 o estendere l'immagine 640 x 480 per riempire lo spazio dello schermo più grande. Se DM_DISPLAYFIXEDOUTPUT non è impostato, questo membro deve essere zero. Se DM_DISPLAYFIXEDOUTPUT è impostato, questo membro deve essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
| DMDFO_DEFAULT | Impostazione predefinita della visualizzazione. |
| DMDFO_CENTER | L'immagine a bassa risoluzione è allineata al centro nello spazio dello schermo più grande. |
| DMDFO_STRETCH | L'immagine a bassa risoluzione viene estesa per riempire lo spazio dello schermo più grande. |
Windows 2000: Non supportato.
dmColor
Passa tra colore e monocromatico sulle stampanti a colori. Di seguito sono indicati i valori possibili:
- DMCOLOR_COLOR
- DMCOLOR_MONOCHROME
dmDuplex
Seleziona la stampa duplex o fronte retro per le stampanti in grado di stampa duplex. Di seguito sono riportati i valori possibili.
| Valore | Significato |
|---|---|
| DMDUP_SIMPLEX | Stampa normale (non plessa). |
| DMDUP_HORIZONTAL | Associazione a arco corto, ovvero il bordo lungo della pagina è orizzontale. |
| DMDUP_VERTICAL | Associazione a arco lungo, ovvero il bordo lungo della pagina è verticale. |
dmYResolution
Specifica la risoluzione y, espressa in punti per pollice, della stampante. Se la stampante inizializza questo membro, il membro dmPrintQuality specifica la risoluzione x, espressa in punti per pollice, della stampante.
dmTTOption
Specifica la modalità di stampa dei tipi di carattere TrueType. Questo membro può essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
| DMTT_BITMAP | Stampa i tipi di carattere TrueType come grafica. Questa è l'azione predefinita per le stampanti a matrice di punti. |
| DMTT_DOWNLOAD | Scarica i tipi di carattere TrueType come tipi di carattere soft. Si tratta dell'azione predefinita per Hewlett-Packard stampanti che usano il linguaggio PCL (Printer Control Language). |
| DMTT_DOWNLOAD_OUTLINE | Scarica i tipi di carattere TrueType come carattere sfumati. |
| DMTT_SUBDEV | Sostituisce i tipi di carattere del dispositivo per i tipi di carattere TrueType. Questa è l'azione predefinita per le stampanti PostScript. |
dmCollate
Specifica se le regole di confronto devono essere utilizzate durante la stampa di più copie. Questo membro viene ignorato a meno che il driver della stampante non indichi il supporto per le regole di confronto impostando il membro dmFields su DM_COLLATE. Questo membro può essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
| DMCOLLATE_TRUE | Collazione durante la stampa di più copie. |
| DMCOLLATE_FALSE | Non confrontare quando si stampano più copie. |
dmFormName[CCHFORMNAME]
Matrice di caratteri con terminazione zero che specifica il nome del modulo da usare; Ad esempio, "Lettera" o "Legale". È possibile recuperare un set completo di nomi usando la funzione EnumForms .
dmLogPixels
Numero di pixel per pollice logico. I driver della stampante non usano questo membro.
dmBitsPerPel
Specifica la risoluzione dei colori, in bit per pixel, del dispositivo di visualizzazione (ad esempio: 4 bit per 16 colori, 8 bit per 256 colori o 16 bit per 65.536 colori). I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.
dmPelsWidth
Specifica la larghezza, in pixel, dell'area del dispositivo visibile. I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.
dmPelsHeight
Specifica l'altezza, in pixel, dell'area del dispositivo visibile. I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.dmDisplayFlags
Specifica la modalità di visualizzazione del dispositivo. Questo membro può essere una combinazione dei valori seguenti.
| Valore | Significato |
|---|---|
| DM_GRAYSCALE | Specifica che la visualizzazione è un dispositivo noncolore. Se questo flag non è impostato, viene assunto il colore. Questo flag non è più valido. |
| DM_INTERLACED | Specifica che la modalità di visualizzazione è interlacciata. Se il flag non è impostato, viene assunto un valore non interlacciato. |
I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.
DUMMYUNIONNAME2.dmNup
Specifica la posizione in cui viene eseguita l'NUP. Può essere uno dei seguenti.
| Valore | Significato |
|---|---|
| DMNUP_SYSTEM | Lo spooler di stampa esegue l'NUP. |
| DMNUP_ONEUP | L'applicazione esegue l'NUP. |
dmDisplayFrequency
Specifica la frequenza, in hertz (cicli al secondo), del dispositivo di visualizzazione in una modalità specifica. Questo valore è noto anche come frequenza di aggiornamento verticale del dispositivo visualizzato. I driver di visualizzazione usano questo membro. Viene usato, ad esempio, nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.
Quando si chiama la funzione EnumDisplaySettings , il membro dmDisplayFrequency può restituire con il valore 0 o 1. Questi valori rappresentano la frequenza di aggiornamento predefinita dell'hardware di visualizzazione. Questa frequenza predefinita è in genere impostata da commutatori su una scheda di visualizzazione o scheda madre del computer o da un programma di configurazione che non usa funzioni di visualizzazione come ChangeDisplaySettings.
dmICMMethod
Specifica il modo in cui viene gestito ICM. Per un'applicazione non ICM, questo membro determina se ICM è abilitato o disabilitato. Per le applicazioni ICM, il sistema esamina questo membro per determinare come gestire il supporto di ICM. Questo membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMICMMETHOD_USER.
| Valore | Significato |
|---|---|
| DMICMMETHOD_NONE | Specifica che ICM è disabilitato. |
| DMICMMETHOD_SYSTEM | Specifica che ICM viene gestito da Windows. |
| DMICMMETHOD_DRIVER | Specifica che ICM viene gestito dal driver di dispositivo. |
| DMICMMETHOD_DEVICE | Specifica che ICM viene gestito dal dispositivo di destinazione. |
Il driver della stampante deve fornire un'interfaccia utente per l'impostazione di questo membro. La maggior parte dei driver della stampante supporta solo il valore DMICMMETHOD_SYSTEM o DMICMMETHOD_NONE. I driver per le stampanti PostScript supportano tutti i valori.
dmICMIntent
Specifica il metodo di corrispondenza dei colori o la finalità da utilizzare per impostazione predefinita. Questo membro è principalmente per applicazioni non ICM. Le applicazioni ICM possono stabilire finalità usando le funzioni ICM. Questo membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMICM_USER.
| Valore | Significato |
|---|---|
| DMICM_ABS_COLORIMETRIC | La corrispondenza dei colori deve essere ottimizzata per corrispondere al colore esatto richiesto senza mapping a punti bianchi. Questo valore è più appropriato per l'uso con la correzione. |
| DMICM_COLORIMETRIC | La corrispondenza dei colori deve essere ottimizzata per corrispondere al colore esatto richiesto. Questo valore è più appropriato per l'uso con logo aziendali o altre immagini quando è desiderata una corrispondenza di colore esatta. |
| DMICM_CONTRAST | La corrispondenza dei colori deve essere ottimizzata per il contrasto dei colori. Questo valore è la scelta più appropriata per le immagini analizzate o fotografiche quando si desidera eseguire il dithering. |
| DMICM_SATURATE | La corrispondenza dei colori deve essere ottimizzata per la saturazione dei colori. Questo valore è la scelta più appropriata per i grafici aziendali quando il dithering non è desiderato. |
dmMediaType
Specifica il tipo di supporto stampato. Il membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMMEDIA_USER.
| Valore | Significato |
|---|---|
| DMMEDIA_STANDARD | Carta semplice. |
| DMMEDIA_GLOSSY | Carta lucida. |
| DMMEDIA_TRANSPARENCY | Film trasparente. |
Per recuperare un elenco dei tipi di supporti disponibili per una stampante, usare la funzione DeviceCapabilities con il flag di DC_MEDIATYPES.
dmDitherType
Specifica come eseguire il dithering. Il membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMDITHER_USER.
| Valore | Significato |
|---|---|
| DMDITHER_NONE | Nessuna dithering. |
| DMDITHER_COARSE | Dithering con un pennello grossolano. |
| DMDITHER_FINE | Dithering con un pennello fine. |
| DMDITHER_LINEART | Dithering della linea, un metodo speciale dithering che produce bordi ben definiti tra la scala nera, bianca e grigia. Non è adatto per immagini che includono la graduazione continua in intensità e tonalità, come le fotografie analizzate. |
| DMDITHER_GRAYSCALE | Il dispositivo esegue il ridimensionamento in grigio. |
dmReserved1
Non utilizzato; deve essere zero.
dmReserved2
Non utilizzato; deve essere zero.
dmPanningWidth
Questo membro deve essere zero.
dmPanningHeight
Questo membro deve essere zero.
Commenti
I dati privati di un driver di dispositivo seguono la parte pubblica della struttura DEVMODE . Le dimensioni dei dati pubblici possono variare per le diverse versioni della struttura. Il membro dmSize specifica il numero di byte di dati pubblici e il membro dmDriverExtra specifica il numero di byte di dati privati.
Nota
L'intestazione wingdi.h definisce DEVMODE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | wingdi.h (include Windows.h) |