Condividi tramite

Struttura DEVMODEA (wingdi.h)

La struttura di 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;

Membri

dmDeviceName[CCHDEVICENAME]

Matrice di caratteri con terminazione zero che specifica il nome "descrittivo" della stampante o dello schermo; 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 driver privati 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 della 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 stampanti, seleziona l'orientamento della carta. Questo membro può essere DMORIENT_PORTRAIT (1) o DMORIENT_LANDSCAPE (2).

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Solo per i dispositivi stampanti, seleziona le dimensioni della carta su cui stampare. Questo membro può essere impostato su zero se la lunghezza e la larghezza della carta 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 per 11 pollici
DMPAPER_LEGAL Legale, 8 1/2- per 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 Foglio ruotato A4, da 297 a 210 millimetri
DMPAPER_A4SMALL A4 piccolo foglio, 210- per 297 millimetri
DMPAPER_A4_TRANSVERSE A4 Transverse 210 x 297 millimetri
DMPAPER_A5 Foglio A5, da 148 a 210 millimetri
DMPAPER_A5_EXTRA A5 Extra 174 x 235 millimetri
DMPAPER_A5_ROTATED Foglio ruotato A5, da 210 a 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, da 148 a 105 millimetri
DMPAPER_A_PLUS SuperA/A4 227 x 356 -millimeters
DMPAPER_B4 Foglio B4, 250- per 354 millimetri
DMPAPER_B4_JIS_ROTATED Foglio ruotato B4 (JIS), 364- per 257 millimetri
DMPAPER_B5 Foglio B5, da 182 a 257 millimetri
DMPAPER_B5_EXTRA B5 (ISO) Extra 201 x 276 millimetri
DMPAPER_B5_JIS_ROTATED Foglio ruotato B5 (JIS), 257- per 182 millimetri
DMPAPER_B6_JIS Foglio B6 (JIS), da 128 a 182 millimetri
DMPAPER_B6_JIS_ROTATED Foglio ruotato B6 (JIS), da 182 a 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 doppia giapponese, da 200 a 148 millimetri
DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED Doppia cartolina giapponese ruotata, da 148 a 200 millimetri
DMPAPER_DSHEET Foglio D, da 22 a 34 pollici
DMPAPER_ENV_9 Busta n. 9, 3 7/8 per 8 pollici
DMPAPER_ENV_10 Busta #10, 4 1/8 per 9 1/2 pollici
DMPAPER_ENV_11 Busta n. 11, 4 1/2 per 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, da 229 a 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, da 176 a 125 millimetri
DMPAPER_ENV_DL Busta DL, da 110 a 220 millimetri
DMPAPER_ENV_INVITE Invito busta 220 x 220 mm
DMPAPER_ENV_ITALY Busta Italia, 110- per 230 millimetri
DMPAPER_ENV_MONARCH Busta Monarch, 3 7/8- per 7 1/2 pollici
DMPAPER_ENV_PERSONAL Busta 6/3/4, 3 5/8 per 6 1/2 pollici
DMPAPER_ESHEET Foglio E, 34- per 44 pollici
DMPAPER_EXECUTIVE Executive, 7 1/4- per 10 1/2 pollici
DMPAPER_FANFOLD_US Fanfold us Std, 14 7/8- 11 pollici
DMPAPER_FANFOLD_STD_GERMAN Fanfolding std tedesco, 8 1/2- per 12 pollici
DMPAPER_FANFOLD_LGL_GERMAN Fanfolding legale tedesco, 8 - 13 pollici
DMPAPER_FOLIO Folio, 8 1/2- per carta da 13 pollici
DMPAPER_ISO_B4 Carta B4 (ISO) da 250 a 353 millimetri
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 n. 3
DMPAPER_JENV_CHOU3_ROTATED Busta giapponese Chou n. 3 ruotata
DMPAPER_JENV_CHOU4 Busta giapponese n. 4
DMPAPER_JENV_CHOU4_ROTATED Busta giapponese n. 4 ruotata
DMPAPER_JENV_KAKU2 Busta giapponese Kaku n. 2
DMPAPER_JENV_KAKU2_ROTATED Busta giapponese Kaku n. 2 ruotata
DMPAPER_JENV_KAKU3 Busta giapponese Kaku n. 3
DMPAPER_JENV_KAKU3_ROTATED Busta giapponese Kaku n. 3 ruotata
DMPAPER_JENV_YOU4 Busta giapponese n. 4
DMPAPER_JENV_YOU4_ROTATED Busta giapponese n. 4 ruotata
DMPAPER_LAST DMPAPER_PENV_10_ROTATED
DMPAPER_LEDGER Libro mastro, 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 11 per 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, 8 1/2- per 11 pollici
DMPAPER_P16K PRC 16K, 146- per 215 millimetri
DMPAPER_P16K_ROTATED PRC 16K ruotato, 215- per 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- per 151 millimetri
DMPAPER_P32KBIG_ROTATED PRC 32K(Big) Ruotato, da 151 a 97 millimetri
DMPAPER_PENV_1 Busta PRC #1, 102- per 165 millimetri
DMPAPER_PENV_1_ROTATED Busta PRC n. 1 ruotata, 165- per 102 millimetri
DMPAPER_PENV_2 Busta PRC #2, 102- per 176 millimetri
DMPAPER_PENV_2_ROTATED Busta PRC n. 2 ruotata, 176- per 102 millimetri
DMPAPER_PENV_3 Busta PRC n. 3, 125- per 176 millimetri
DMPAPER_PENV_3_ROTATED Busta PRC n. 3 ruotata, 176- per 125 millimetri
DMPAPER_PENV_4 Busta PRC n. 4, 110- per 208 millimetri
DMPAPER_PENV_4_ROTATED Busta PRC n. 4 ruotata, 208- per 110 millimetri
DMPAPER_PENV_5 Busta PRC n. 5, 110- per 220 millimetri
DMPAPER_PENV_5_ROTATED Busta PRC n. 5 ruotata, 220- per 110 millimetri
DMPAPER_PENV_6 Busta PRC n. 6, 120- per 230 millimetri
DMPAPER_PENV_6_ROTATED Busta PRC n. 6 ruotata, 230- per 120 millimetri
DMPAPER_PENV_7 Busta PRC 7, 160- per 230 millimetri
DMPAPER_PENV_7_ROTATED Busta PRC n. 7 ruotata, 230- per 160 millimetri
DMPAPER_PENV_8 Busta PRC n. 8, 120- per 309 millimetri
DMPAPER_PENV_8_ROTATED Busta PRC n. 8 ruotata, 309- per 120 millimetri
DMPAPER_PENV_9 Busta PRC n. 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- per 458 millimetri
DMPAPER_PENV_10_ROTATED Busta PRC n. 10 ruotata, 458- per 324 millimetri
DMPAPER_QUARTO Quarto, carta da 215 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 stampanti, esegue l'override della lunghezza della carta specificata dal membro dmPaperSize , per formati di carta personalizzati o per dispositivi come stampanti a matrice di punti che possono stampare in 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 della carta specificata dal membro dmPaperSize .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

Specifica il fattore in base al quale deve essere ridimensionato l'output stampato. La dimensione apparente della pagina viene ridimensionata dalle dimensioni della pagina fisica 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 una pagina di 17- di 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 origini cartacee 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 (misurato in senso antiorario) da DMDO_DEFAULT.
DMDO_180 L'orientamento dello schermo viene ruotato di 180 gradi (misurato in senso antiorario) da DMDO_DEFAULT.
DMDO_270 L'orientamento dello schermo viene ruotato di 270 gradi (misurato in senso antiorario) 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, in che modo 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 sua modalità è impostata su 640 x 480 pixel, il dispositivo può visualizzare un'immagine 640 x 480 in un punto all'interno 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 colori e monocromatici sulle stampanti a colori. Di seguito sono indicati i valori possibili:

  • DMCOLOR_COLOR
  • DMCOLOR_MONOCHROME

dmDuplex

Seleziona la stampa duplex o doppia per stampanti in grado di stampa duplex. Di seguito sono riportati i valori possibili.

Valore Significato
DMDUP_SIMPLEX Stampa normale (nonduplex).
DMDUP_HORIZONTAL Associazione a bordo corto, ovvero il bordo lungo della pagina è orizzontale.
DMDUP_VERTICAL Associazione a bordi lunghi, 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. Questa è l'azione predefinita per le stampanti Hewlett-Packard che usano il linguaggio di controllo stampante (PCL).
DMTT_DOWNLOAD_OUTLINE Scarica i tipi di carattere TrueType come caratteri soft della struttura.
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 eseguire la collazione durante la stampa di più copie.

dmFormName[CCHFORMNAME]

Matrice di caratteri con terminazione zero che specifica il nome del modulo da utilizzare; 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 utilizzano 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 utilizzano questo membro.

dmPelsWidth

Specifica la larghezza, espressa in pixel, della superficie del dispositivo visibile. I driver di visualizzazione usano questo membro, ad esempio, nella funzione ChangeDisplaySettings . I driver della stampante non utilizzano questo membro.

dmPelsHeight

Specifica l'altezza, in pixel, della superficie del dispositivo visibile. I driver di visualizzazione usano questo membro, ad esempio, nella funzione ChangeDisplaySettings . I driver della stampante non utilizzano 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 noncolor. Se questo flag non è impostato, viene utilizzato il colore. Questo flag non è più valido.
DM_INTERLACED Specifica che la modalità di visualizzazione è interlacciata. Se il flag non è impostato, viene utilizzato un valore non interlacciato.
 

I driver di visualizzazione usano questo membro, ad esempio, nella funzione ChangeDisplaySettings . I driver della stampante non utilizzano questo membro.

DUMMYUNIONNAME2.dmNup

Specifica la posizione in cui viene eseguita l'NUP. Può trattarsi di uno dei seguenti elementi.

Valore Significato
DMNUP_SYSTEM Lo spooler di stampa esegue l'NUP.
DMNUP_ONEUP L'applicazione esegue il NUP.

dmDisplayFrequency

Specifica la frequenza, inhz (cicli al secondo) del dispositivo di visualizzazione in una particolare modalità. Questo valore è noto anche come frequenza di aggiornamento verticale del dispositivo di visualizzazione. I driver di visualizzazione usano questo membro. Viene usato, ad esempio, nella funzione ChangeDisplaySettings . I driver della stampante non utilizzano 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 viene in genere impostata da interruttori 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 la modalità di gestione di 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 ICM. Questo membro può essere uno dei valori predefiniti seguenti oppure 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 o la finalità di corrispondenza dei colori da utilizzare per impostazione predefinita. Questo membro è principalmente per le applicazioni non ICM. Le applicazioni ICM possono stabilire finalità usando le funzioni ICM. Questo membro può essere uno dei valori predefiniti seguenti oppure 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 in modo che corrisponda al colore esatto richiesto senza il mapping dei punti bianchi. Questo valore è più appropriato per l'uso con la correzione.
DMICM_COLORIMETRIC La corrispondenza dei colori deve essere ottimizzata in modo che corrisponda al colore esatto richiesto. Questo valore è più appropriato per l'uso con logo aziendali o altre immagini quando si desidera 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 digitalizzate o fotografiche quando si desidera il dithering.
DMICM_SATURATE La corrispondenza dei colori deve essere ottimizzata per la saturazione del colore. Questo valore è la scelta più appropriata per i grafici aziendali quando la dithering non è desiderata.

dmMediaType

Specifica il tipo di supporto su cui viene stampato. Il membro può essere uno dei valori predefiniti seguenti oppure 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 Pellicola trasparente.
 

Per recuperare un elenco dei tipi di supporto disponibili per una stampante, usare la funzione DeviceCapabilities con il flag DC_MEDIATYPES.

dmDitherType

Specifica il modo in cui deve essere eseguita la dithering. Il membro può essere uno dei valori predefiniti seguenti oppure un valore definito dal driver maggiore o uguale al valore di DMDITHER_USER.

Valore Significato
DMDITHER_NONE Nessun dithering.
DMDITHER_COARSE Dithering con un pennello grossolano.
DMDITHER_FINE Dithering con un pennello fine.
DMDITHER_LINEART Dithering lineare, 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 la scalabilità grigia.

dmReserved1

Non utilizzato; deve essere zero.

dmReserved2

Non utilizzato; deve essere zero.

dmPanningWidth

Questo membro deve essere zero.

dmPanningHeight

Questo membro deve essere zero.

Osservazioni:

I dati privati di un driver di dispositivo seguono la parte pubblica della struttura DEVMODE . Le dimensioni dei dati pubblici possono variare per versioni diverse 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.

Annotazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per ulteriori 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)

Vedere anche

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

DocumentProperties

EnumDisplaySettings

OpenPrinter

stampare strutture API Spooler

Stampa

  • Last updated on