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 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 , não incluindo dados específicos do driver privado que possam seguir os membros públicos da estrutura. Defina esse membro para sizeof (DEVMODE) 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 somente aos membros DEVMODE apropriados para a tecnologia de impressão ou de exibição.

Os valores a seguir são definidos e estão listados aqui com os membros da estrutura correspondentes.

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 seguintes valores predefinidos.

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 ponto 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 da página aparente é 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 tanto dados quanto uma página de 17 por 22 polegadas porque o texto de saída e os 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 seguintes valores 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 especifica o número de pontos por polegada (DPI) e, portanto, é 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 em 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 seguintes valores

Para determinar se a orientação de exibição é orientação retrato ou paisagem, verifique a proporção de dmPelsWidth para dmPelsHeight.

Windows 2000: Não há suporte.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Somente para dispositivos de exibição de resolução fixa, como a exibição apresenta um modo de baixa resolução em uma exibição de resolução mais alta. Por exemplo, se a resolução de um dispositivo de exibição 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 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.

Windows 2000: Não há suporte.

dmColor

Alterna entre cores e monocromáticas em impressoras de cores. Veja a seguir os valores possíveis:

• DMCOLOR_COLOR
• DMCOLOR_MONOCHROME

dmDuplex

Seleciona impressão duplex ou de dois lados para impressoras capazes de impressão duplex. A seguir estão os valores possíveis.

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 seguintes valores.

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 seguintes valores.

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 do dispositivo visível. 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 do dispositivo visível. 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.

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.

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. Essa taxa padrão normalmente é 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.

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 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 do ICM. Esse membro pode ser um dos seguintes valores predefinidos ou um valor definido pelo driver maior ou igual ao valor de DMICM_USER.

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.

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.

dmReserved1

Não usado; deve ser zero.

dmReserved2

Não usado; deve ser zero.

dmPanningWidth

Esse membro deve ser zero.

dmPanningHeight

Esse membro deve ser zero.

Observações

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.

Requisitos

Consulte também

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

DocumentProperties

EnumDisplaySettings

OpenPrinter

estruturas da API do Spooler de Impressão

Impressão