Estrutura DEVMODEA (wingdi.h)
A estrutura de dados DEVMODE contém informações sobre a inicialização e o ambiente de uma impressora ou um dispositivo de exibição.
Sintaxe
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;
Membros
dmDeviceName[CCHDEVICENAME]
Uma matriz de caracteres com término zero que especifica o nome "amigável" da impressora ou da exibição; por exemplo, "PCL/HP LaserJet" no caso de PCL/HP LaserJet. Essa cadeia de caracteres é exclusiva entre os drivers de dispositivo. Observe que esse nome pode ser truncado para caber na matriz dmDeviceName .
dmSpecVersion
O número de versão da especificação de dados de inicialização na qual a estrutura se baseia. Para garantir que a versão correta seja usada para qualquer sistema operacional, use DM_SPECVERSION.
dmDriverVersion
O número de versão do driver atribuído pelo desenvolvedor do driver.
dmSize
Especifica o tamanho, em bytes, da estrutura DEVMODE , sem incluir nenhum dado específico do driver privado que possa seguir os membros públicos da estrutura. Defina esse membro como sizeof (DEVMODE) para indicar a versão da estrutura DEVMODE que está sendo usada.
dmDriverExtra
Contém o número de bytes de dados de driver privados que seguem essa estrutura. Se um driver de dispositivo não usar informações específicas do dispositivo, defina esse membro como zero.
dmFields
Especifica se determinados membros da estrutura DEVMODE foram inicializados. Se um membro for inicializado, seu bit correspondente será definido, caso contrário, o bit estará claro. Um driver dá suporte apenas aos membros DEVMODE apropriados para a impressora ou tecnologia de exibição.
Os valores a seguir são definidos e são listados aqui com os membros da estrutura correspondentes.
| Valor | Membro da estrutura |
|---|---|
| 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
Somente para dispositivos de impressora, seleciona a orientação do papel. Esse membro pode ser DMORIENT_PORTRAIT (1) ou DMORIENT_LANDSCAPE (2).
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize
Somente para dispositivos de impressora, seleciona o tamanho do papel no qual imprimir. Esse membro poderá ser definido como zero se o comprimento e a largura do papel forem definidos pelos membros dmPaperLength e dmPaperWidth . Caso contrário, o membro dmPaperSize pode ser definido como um valor específico do dispositivo maior ou igual a DMPAPER_USER ou para um dos valores predefinidos a seguir.
| Valor | Significado |
|---|---|
| DMPAPER_LETTER | Letra, 8 1/2- por 11 polegadas |
| DMPAPER_LEGAL | Legal, 8 1/2- por 14 polegadas |
| DMPAPER_9X11 | Folha de 9 por 11 polegadas |
| DMPAPER_10X11 | Folha de 10 por 11 polegadas |
| DMPAPER_10X14 | Folha de 10 por 14 polegadas |
| DMPAPER_15X11 | Folha de 15 por 11 polegadas |
| DMPAPER_11X17 | Folha de 11 por 17 polegadas |
| DMPAPER_12X11 | Folha de 12 por 11 polegadas |
| DMPAPER_A2 | Folha A2, 420 x 594 milímetros |
| DMPAPER_A3 | Folha A3, 297 por 420 milímetros |
| DMPAPER_A3_EXTRA | A3 Extra 322 x 445 milímetros |
| DMPAPER_A3_EXTRA_TRAVERSE | A3 Transversal Extra 322 x 445 milímetros |
| DMPAPER_A3_ROTATED | Folha girada A3, 420 por 297 milímetros |
| DMPAPER_A3_TRAVERSE | A3 Transverse 297 x 420 milímetros |
| DMPAPER_A4 | Folha A4, 210 por 297 milímetros |
| DMPAPER_A4_EXTRA | Folha A4, 9,27 x 12,69 polegadas |
| DMPAPER_A4_PLUS | A4 Plus 210 x 330 milímetros |
| DMPAPER_A4_ROTATED | Folha girada A4, 297 por 210 milímetros |
| DMPAPER_A4SMALL | Folha pequena A4, 210 por 297 milímetros |
| DMPAPER_A4_TRANSVERSE | A4 Transverse 210 x 297 milímetros |
| DMPAPER_A5 | Folha A5, 148 por 210 milímetros |
| DMPAPER_A5_EXTRA | A5 Extra 174 x 235 milímetros |
| DMPAPER_A5_ROTATED | Folha girada A5, 210 por 148 milímetros |
| DMPAPER_A5_TRANSVERSE | A5 Transverse 148 x 210 milímetros |
| DMPAPER_A6 | Folha A6, 105 por 148 milímetros |
| DMPAPER_A6_ROTATED | Folha girada A6, 148 por 105 milímetros |
| DMPAPER_A_PLUS | SuperA/A4 227 x 356 -milímetros |
| DMPAPER_B4 | Folha B4, 250 por 354 milímetros |
| DMPAPER_B4_JIS_ROTATED | Planilha girada B4 (JIS), 364 por 257 milímetros |
| DMPAPER_B5 | Folha B5, papel de 182 por 257 milímetros |
| DMPAPER_B5_EXTRA | B5 (ISO) Extra 201 x 276 milímetros |
| DMPAPER_B5_JIS_ROTATED | Planilha girada B5 (JIS), 257 por 182 milímetros |
| DMPAPER_B6_JIS | Planilha B6 (JIS), 128 por 182 milímetros |
| DMPAPER_B6_JIS_ROTATED | Planilha girada B6 (JIS), 182 por 128 milímetros |
| DMPAPER_B_PLUS | SuperB/A3 305 x 487 milímetros |
| DMPAPER_CSHEET | Folha C, 17 por 22 polegadas |
| DMPAPER_DBL_JAPANESE_POSTCARD | Cartão postal japonês duplo, 200 por 148 milímetros |
| DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED | Cartão postal japonês duplo girado, 148 por 200 milímetros |
| DMPAPER_DSHEET | Folha D, 22 por 34 polegadas |
| DMPAPER_ENV_9 | Envelope nº 9, 3 7/8- por 8 7/8 polegadas |
| DMPAPER_ENV_10 | Envelope nº 10, 4 1/8- por 9 1/2 polegadas |
| DMPAPER_ENV_11 | Envelope nº 11, 4 1/2- por 10 3/8 polegadas |
| DMPAPER_ENV_12 | Envelope nº 12, 4 3/4- por 11 polegadas |
| DMPAPER_ENV_14 | Envelope nº 14, 5 por 11 1/2 polegadas |
| DMPAPER_ENV_C5 | Envelope C5, 162 por 229 milímetros |
| DMPAPER_ENV_C3 | Envelope C3, 324 por 458 milímetros |
| DMPAPER_ENV_C4 | Envelope C4, 229 por 324 milímetros |
| DMPAPER_ENV_C6 | Envelope C6, 114 por 162 milímetros |
| DMPAPER_ENV_C65 | Envelope C65, 114 por 229 milímetros |
| DMPAPER_ENV_B4 | Envelope B4, 250 por 353 milímetros |
| DMPAPER_ENV_B5 | Envelope B5, 176 por 250 milímetros |
| DMPAPER_ENV_B6 | Envelope B6, 176 por 125 milímetros |
| DMPAPER_ENV_DL | Envelope DL, 110 por 220 milímetros |
| DMPAPER_ENV_INVITE | Convite para Envelope 220 x 220 mm |
| DMPAPER_ENV_ITALY | Envelope Itália, 110 por 230 milímetros |
| DMPAPER_ENV_MONARCH | Envelope Monarch, 3 7/8- por 7 1/2 polegadas |
| DMPAPER_ENV_PERSONAL | 6 envelope 3/4, 3 5/8- por 6 1/2 polegadas |
| DMPAPER_ESHEET | E Sheet, 34 por 44 polegadas |
| DMPAPER_EXECUTIVE | Executivo, 7 1/4- por 10 1/2 polegadas |
| DMPAPER_FANFOLD_US | US Std Fanfold, 14 7/8- por 11 polegadas |
| DMPAPER_FANFOLD_STD_GERMAN | Std Fanfold alemão, 8 1/2- por 12 polegadas |
| DMPAPER_FANFOLD_LGL_GERMAN | German Legal Fanfold, 8 - por 13 polegadas |
| DMPAPER_FOLIO | Folio, 8 1/2- por papel de 13 polegadas |
| DMPAPER_ISO_B4 | B4 (ISO) 250- por papel de 353 milímetros |
| DMPAPER_JAPANESE_POSTCARD | Cartão postal japonês, 100 por 148 milímetros |
| DMPAPER_JAPANESE_POSTCARD_ROTATED | Cartão postal japonês girado, 148 por 100 milímetros |
| DMPAPER_JENV_CHOU3 | Envelope Japonês Chou nº 3 |
| DMPAPER_JENV_CHOU3_ROTATED | Envelope Japonês Chou #3 Girado |
| DMPAPER_JENV_CHOU4 | Envelope Japonês Chou nº 4 |
| DMPAPER_JENV_CHOU4_ROTATED | Envelope Japonês Chou #4 Girado |
| DMPAPER_JENV_KAKU2 | Envelope japonês Kaku nº 2 |
| DMPAPER_JENV_KAKU2_ROTATED | Envelope japonês Kaku nº 2 Girado |
| DMPAPER_JENV_KAKU3 | Envelope Japonês Kaku nº 3 |
| DMPAPER_JENV_KAKU3_ROTATED | Envelope Japonês Kaku nº 3 Girado |
| DMPAPER_JENV_YOU4 | Envelope japonês 4 |
| DMPAPER_JENV_YOU4_ROTATED | Envelope japonês nº 4 girado |
| DMPAPER_LAST | DMPAPER_PENV_10_ROTATED |
| DMPAPER_LEDGER | Razão, 17 por 11 polegadas |
| DMPAPER_LEGAL_EXTRA | Legal Extra 9 1/2 x 15 polegadas. |
| DMPAPER_LETTER_EXTRA | Letra Extra 9 1/2 x 12 polegadas. |
| DMPAPER_LETTER_EXTRA_TRANSVERSE | Letra Transversal Extra 9 1/2 x 12 polegadas. |
| DMPAPER_LETTER_ROTATED | Letra Girada 11 por 8 1/2 polegadas |
| DMPAPER_LETTERSMALL | Letra Pequena, 8 1/2- por 11 polegadas |
| DMPAPER_LETTER_TRANSVERSE | Letra Transversal 8 1/2 x 11 polegadas |
| DMPAPER_NOTE | Observação, 8 1/2- por 11 polegadas |
| DMPAPER_P16K | PRC 16K, 146 por 215 milímetros |
| DMPAPER_P16K_ROTATED | PRC 16K Girada, 215 por 146 milímetros |
| DMPAPER_P32K | PRC 32K, 97- por 151 milímetros |
| DMPAPER_P32K_ROTATED | PRC 32K Girado, 151 por 97 milímetros |
| DMPAPER_P32KBIG | PRC 32K(Big) 97- por 151 milímetros |
| DMPAPER_P32KBIG_ROTATED | PRC 32K(Big) Girado, 151 por 97 milímetros |
| DMPAPER_PENV_1 | Envelope prc nº 1, 102- por 165 milímetros |
| DMPAPER_PENV_1_ROTATED | Envelope prc nº 1 girado, 165- por 102 milímetros |
| DMPAPER_PENV_2 | Envelope prc nº 2, 102- por 176 milímetros |
| DMPAPER_PENV_2_ROTATED | Envelope prc nº 2 girado, 176 por 102 milímetros |
| DMPAPER_PENV_3 | Envelope prc nº 3, 125- por 176 milímetros |
| DMPAPER_PENV_3_ROTATED | Envelope prc nº 3 girado, 176 por 125 milímetros |
| DMPAPER_PENV_4 | Envelope prc nº 4, 110 por 208 milímetros |
| DMPAPER_PENV_4_ROTATED | Envelope prc nº 4 girado, 208- por 110 milímetros |
| DMPAPER_PENV_5 | Envelope prc nº 5, 110 por 220 milímetros |
| DMPAPER_PENV_5_ROTATED | Envelope prc nº 5 girado, 220 por 110 milímetros |
| DMPAPER_PENV_6 | Envelope prc nº 6, 120 por 230 milímetros |
| DMPAPER_PENV_6_ROTATED | Envelope prc nº 6 girado, 230 por 120 milímetros |
| DMPAPER_PENV_7 | Envelope prc nº 7, 160 por 230 milímetros |
| DMPAPER_PENV_7_ROTATED | Envelope prc nº 7 girado, 230 por 160 milímetros |
| DMPAPER_PENV_8 | Envelope PRC nº 8, 120 por 309 milímetros |
| DMPAPER_PENV_8_ROTATED | Envelope prc nº 8 girado, 309 por 120 milímetros |
| DMPAPER_PENV_9 | Envelope PRC nº 9, 229 por 324 milímetros |
| DMPAPER_PENV_9_ROTATED | Envelope prc nº 9 girado, 324 por 229 milímetros |
| DMPAPER_PENV_10 | Envelope PRC nº 10, 324 por 458 milímetros |
| DMPAPER_PENV_10_ROTATED | Envelope prc nº 10 girado, 458 por 324 milímetros |
| DMPAPER_QUARTO | Quarto, 215- por papel de 275 milímetros |
| DMPAPER_STATEMENT | Instrução, 5 1/2- por 8 1/2 polegadas |
| DMPAPER_TABLOID | Tablóide, 11 por 17 polegadas |
| DMPAPER_TABLOID_EXTRA | Tablóide, 11,69 x 18 polegadas |
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength
Somente para dispositivos de impressora, substitui o comprimento do papel especificado pelo membro dmPaperSize , seja para tamanhos de papel personalizados ou para dispositivos como impressoras de matriz de pontos que podem imprimir em uma página de comprimento arbitrário. Esses valores, juntamente com todos os outros valores nessa estrutura que especificam um comprimento físico, estão em décimos de milímetro.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth
Somente para dispositivos de impressora, substitui a largura do papel especificado pelo membro dmPaperSize .
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale
Especifica o fator pelo qual a saída impressa deve ser dimensionada. O tamanho aparente da página é dimensionado do tamanho da página física por um fator de dmScale /100. Por exemplo, uma página do tamanho de uma letra com um valor dmScale de 50 conteria tantos dados quanto uma página de 17 por 22 polegadas porque o texto de saída e os elementos gráficos seriam metade de sua altura e largura originais.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies
Seleciona o número de cópias impressas se o dispositivo der suporte a cópias de várias páginas.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource
Especifica a origem do papel. Para recuperar uma lista das fontes de papel disponíveis para uma impressora, use a função DeviceCapabilities com o sinalizador DC_BINS.
Esse membro pode ser um dos valores a seguir ou pode ser um valor específico do dispositivo maior ou igual a DMBIN_USER.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality
Especifica a resolução da impressora. Há quatro valores predefinidos independentes do dispositivo:
Se um valor positivo for especificado, ele especificará o número de pontos por polegada (DPI) e, portanto, será dependente do dispositivo.
DUMMYUNIONNAME.dmPosition
DUMMYUNIONNAME.DUMMYSTRUCTNAME2
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition
Somente para dispositivos de exibição, uma estrutura POINTL que indica as coordenadas posicionais do dispositivo de exibição em referência à área de trabalho. O dispositivo de exibição primário está sempre localizado nas coordenadas (0,0).
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation
Somente para dispositivos de exibição, a orientação na qual as imagens devem ser apresentadas. Se DM_DISPLAYORIENTATION não estiver definido, esse membro deverá ser zero. Se DM_DISPLAYORIENTATION estiver definido, esse membro deverá ser um dos valores a seguir
| Valor | Significado |
|---|---|
| DMDO_DEFAULT | A orientação de exibição é a orientação natural do dispositivo de exibição; ele deve ser usado como o padrão. |
| DMDO_90 | A orientação de exibição é girada a 90 graus (medido no sentido horário) de DMDO_DEFAULT. |
| DMDO_180 | A orientação de exibição é girada a 180 graus (medida no sentido horário) de DMDO_DEFAULT. |
| DMDO_270 | A orientação de exibição é girada a 270 graus (medida no sentido horário) de DMDO_DEFAULT. |
Para determinar se a orientação de exibição é de orientação retrato ou paisagem, marcar a proporção de dmPelsWidth para dmPelsHeight.
Windows 2000: Sem suporte.
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput
Somente para dispositivos de exibição de resolução fixa, como a tela apresenta um modo de baixa resolução em uma tela de resolução mais alta. Por exemplo, se a resolução de um dispositivo de vídeo for fixada em 1024 x 768 pixels, mas seu modo estiver definido como 640 x 480 pixels, o dispositivo poderá exibir uma imagem de 640 x 480 em algum lugar no interior do espaço de tela 1024 x 768 ou esticar a imagem de 640 x 480 para preencher o espaço de tela maior. Se DM_DISPLAYFIXEDOUTPUT não estiver definido, esse membro deverá ser zero. Se DM_DISPLAYFIXEDOUTPUT estiver definido, esse membro deverá ser um dos valores a seguir.
| Valor | Significado |
|---|---|
| DMDFO_DEFAULT | A configuração padrão da exibição. |
| DMDFO_CENTER | A imagem de baixa resolução é centralizada no espaço de tela maior. |
| DMDFO_STRETCH | A imagem de baixa resolução é ampliada para preencher o espaço de tela maior. |
Windows 2000: Sem suporte.
dmColor
Alterna entre cores e monocromáticos em impressoras coloridas. O valores possíveis são os seguintes:
- DMCOLOR_COLOR
- DMCOLOR_MONOCHROME
dmDuplex
Seleciona a impressão duplex ou de dois lados para impressoras capazes de imprimir duplex. A seguir estão os valores possíveis.
| Valor | Significado |
|---|---|
| DMDUP_SIMPLEX | Impressão normal (nonduplex). |
| DMDUP_HORIZONTAL | A associação de borda curta, ou seja, a borda longa da página é horizontal. |
| DMDUP_VERTICAL | Associação de borda longa, ou seja, a borda longa da página é vertical. |
dmYResolution
Especifica a resolução y, em pontos por polegada, da impressora. Se a impressora inicializar esse membro, o membro dmPrintQuality especificará a resolução x, em pontos por polegada, da impressora.
dmTTOption
Especifica como as fontes TrueType devem ser impressas. Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
| DMTT_BITMAP | Imprime fontes TrueType como gráficos. Essa é a ação padrão para impressoras de matriz de pontos. |
| DMTT_DOWNLOAD | Baixa fontes TrueType como fontes suaves. Essa é a ação padrão para impressoras Hewlett-Packard que usam PCL (Linguagem de Controle de Impressora). |
| DMTT_DOWNLOAD_OUTLINE | Baixa fontes TrueType como fontes suaves de estrutura de tópicos. |
| DMTT_SUBDEV | Substitui fontes de dispositivo por fontes TrueType. Essa é a ação padrão para impressoras PostScript. |
dmCollate
Especifica se a ordenação deve ser usada ao imprimir várias cópias. (Esse membro é ignorado, a menos que o driver da impressora indique suporte para ordenação definindo o membro dmFields como DM_COLLATE.) Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
| DMCOLLATE_TRUE | Agrupar ao imprimir várias cópias. |
| DMCOLLATE_FALSE | Não agrupar ao imprimir várias cópias. |
dmFormName[CCHFORMNAME]
Uma matriz de caracteres com término zero que especifica o nome do formulário a ser usado; por exemplo, "Carta" ou "Legal". Um conjunto completo de nomes pode ser recuperado usando a função EnumForms .
dmLogPixels
O número de pixels por polegada lógica. Os drivers de impressora não usam esse membro.
dmBitsPerPel
Especifica a resolução de cores, em bits por pixel, do dispositivo de exibição (por exemplo: 4 bits para 16 cores, 8 bits para 256 cores ou 16 bits para 65.536 cores). Os drivers de exibição usam esse membro, por exemplo, na função ChangeDisplaySettings . Os drivers de impressora não usam esse membro.
dmPelsWidth
Especifica a largura, em pixels, da superfície visível do dispositivo. Os drivers de exibição usam esse membro, por exemplo, na função ChangeDisplaySettings . Os drivers de impressora não usam esse membro.
dmPelsHeight
Especifica a altura, em pixels, da superfície visível do dispositivo. Os drivers de exibição usam esse membro, por exemplo, na função ChangeDisplaySettings . Os drivers de impressora não usam esse membro.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.dmDisplayFlags
Especifica o modo de exibição do dispositivo. Esse membro pode ser uma combinação dos valores a seguir.
| Valor | Significado |
|---|---|
| DM_GRAYSCALE | Especifica que a exibição é um dispositivo nãocolor. Se esse sinalizador não estiver definido, a cor será assumida. Esse sinalizador não é mais válido. |
| DM_INTERLACED | Especifica que o modo de exibição está entrelaçado. Se o sinalizador não estiver definido, não entrelaçado será assumido. |
Os drivers de exibição usam esse membro, por exemplo, na função ChangeDisplaySettings . Os drivers de impressora não usam esse membro.
DUMMYUNIONNAME2.dmNup
Especifica onde o NUP é feito. Pode ser um dos seguintes.
| Valor | Significado |
|---|---|
| DMNUP_SYSTEM | O spooler de impressão faz o NUP. |
| DMNUP_ONEUP | O aplicativo faz o NUP. |
dmDisplayFrequency
Especifica a frequência, em hertz (ciclos por segundo), do dispositivo de exibição em um modo específico. Esse valor também é conhecido como a taxa de atualização vertical do dispositivo de exibição. Os drivers de exibição usam esse membro. Ele é usado, por exemplo, na função ChangeDisplaySettings . Os drivers de impressora não usam esse membro.
Quando você chama a função EnumDisplaySettings , o membro dmDisplayFrequency pode retornar com o valor 0 ou 1. Esses valores representam a taxa de atualização padrão do hardware de exibição. Normalmente, essa taxa padrão é definida por comutadores em um cartão de exibição ou placa-mãe do computador ou por um programa de configuração que não usa funções de exibição, como ChangeDisplaySettings.
dmICMMethod
Especifica como o ICM é tratado. Para um aplicativo não ICM, esse membro determina se o ICM está habilitado ou desabilitado. Para aplicativos ICM, o sistema examina esse membro para determinar como lidar com o suporte do ICM. Esse membro pode ser um dos seguintes valores predefinidos ou um valor definido pelo driver maior ou igual ao valor de DMICMMETHOD_USER.
| Valor | Significado |
|---|---|
| DMICMMETHOD_NONE | Especifica que o ICM está desabilitado. |
| DMICMMETHOD_SYSTEM | Especifica que o ICM é manipulado pelo Windows. |
| DMICMMETHOD_DRIVER | Especifica que o ICM é manipulado pelo driver do dispositivo. |
| DMICMMETHOD_DEVICE | Especifica que o ICM é manipulado pelo dispositivo de destino. |
O driver da impressora deve fornecer uma interface do usuário para definir esse membro. A maioria dos drivers de impressora dá suporte apenas ao valor de DMICMMETHOD_SYSTEM ou DMICMMETHOD_NONE. Os drivers para impressoras PostScript dão suporte a todos os valores.
dmICMIntent
Especifica qual método de correspondência de cores, ou intenção, deve ser usado por padrão. Esse membro é principalmente para aplicativos que não são ICM. Os aplicativos ICM podem estabelecer intenções usando as funções ICM. Esse membro pode ser um dos seguintes valores predefinidos ou um valor definido pelo driver maior ou igual ao valor de DMICM_USER.
| Valor | Significado |
|---|---|
| DMICM_ABS_COLORIMETRIC | A correspondência de cores deve otimizar para corresponder à cor exata solicitada sem mapeamento de ponto branco. Esse valor é mais apropriado para uso com revisão de texto. |
| DMICM_COLORIMETRIC | A correspondência de cores deve otimizar para corresponder à cor exata solicitada. Esse valor é mais apropriado para uso com logotipos de negócios ou outras imagens quando uma correspondência de cor exata é desejada. |
| DMICM_CONTRAST | A correspondência de cores deve otimizar para contraste de cores. Esse valor é a opção mais apropriada para imagens digitalizadas ou fotográficas quando o dithering é desejado. |
| DMICM_SATURATE | A correspondência de cores deve otimizar para saturação de cores. Esse valor é a escolha mais apropriada para grafos de negócios quando o dithering não é desejado. |
dmMediaType
Especifica o tipo de mídia que está sendo impressa. O membro pode ser um dos seguintes valores predefinidos ou um valor definido pelo driver maior ou igual ao valor de DMMEDIA_USER.
| Valor | Significado |
|---|---|
| DMMEDIA_STANDARD | Papel comum. |
| DMMEDIA_GLOSSY | Papel brilhante. |
| DMMEDIA_TRANSPARENCY | Filme transparente. |
Para recuperar uma lista dos tipos de mídia disponíveis para uma impressora, use a função DeviceCapabilities com o sinalizador DC_MEDIATYPES.
dmDitherType
Especifica como o dithering deve ser feito. O membro pode ser um dos seguintes valores predefinidos ou um valor definido pelo driver maior ou igual ao valor de DMDITHER_USER.
| Valor | Significado |
|---|---|
| DMDITHER_NONE | Sem dithering. |
| DMDITHER_COARSE | Dithering com um pincel grosseiro. |
| DMDITHER_FINE | Dithering com um pincel fino. |
| DMDITHER_LINEART | Dithering de arte de linha, um método de dithering especial que produz bordas bem definidas entre o dimensionamento preto, branco e cinza. Não é adequado para imagens que incluem formaturas contínuas em intensidade e matiz, como fotografias digitalizadas. |
| DMDITHER_GRAYSCALE | O dispositivo faz dimensionamento cinza. |
dmReserved1
Não usado, precisa ser zero.
dmReserved2
Não usado, precisa ser zero.
dmPanningWidth
Esse membro deve ser zero.
dmPanningHeight
Esse membro deve ser zero.
Comentários
Os dados privados de um driver de dispositivo seguem a parte pública da estrutura DEVMODE . O tamanho dos dados públicos pode variar para versões diferentes da estrutura. O membro dmSize especifica o número de bytes de dados públicos e o membro dmDriverExtra especifica o número de bytes de dados privados.
Observação
O cabeçalho wingdi.h define DEVMODE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | wingdi.h (inclua Windows.h) |