Structure DEVMODEA (wingdi.h)

La structure de données DEVMODE contient des informations sur l’initialisation et l’environnement d’une imprimante ou d’un appareil d’affichage.

Syntaxe

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;

Membres

dmDeviceName[CCHDEVICENAME]

Tableau de caractères sans fin qui spécifie le nom « convivial » de l’imprimante ou de l’affichage ; par exemple, « PCL/HP LaserJet » dans le cas de PCL/HP LaserJet. Cette chaîne est unique parmi les pilotes de périphérique. Notez que ce nom peut être tronqué pour s’adapter au tableau dmDeviceName .

dmSpecVersion

Numéro de version de la spécification des données d’initialisation sur laquelle la structure est basée. Pour vous assurer que la version correcte est utilisée pour n’importe quel système d’exploitation, utilisez DM_SPECVERSION.

dmDriverVersion

Numéro de version du pilote attribué par le développeur du pilote.

dmSize

Spécifie la taille, en octets, de la structure DEVMODE , sans inclure les données spécifiques au pilote privé susceptibles de suivre les membres publics de la structure. Définissez ce membre pour sizeof (DEVMODE) indiquer la version de la structure DEVMODE utilisée.

dmDriverExtra

Contient le nombre d’octets de données de pilote privé qui suivent cette structure. Si un pilote de périphérique n’utilise pas d’informations spécifiques à l’appareil, définissez ce membre sur zéro.

dmFields

Spécifie si certains membres de la structure DEVMODE ont été initialisés. Si un membre est initialisé, son bit correspondant est défini, sinon le bit est clair. Un pilote prend uniquement en charge les membres DEVMODE appropriés pour l’imprimante ou la technologie d’affichage.

Les valeurs suivantes sont définies et sont répertoriées ici avec les membres de la structure correspondants.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation

Pour les périphériques d’imprimante uniquement, sélectionne l’orientation du papier. Ce membre peut être DMORIENT_PORTRAIT (1) ou DMORIENT_LANDSCAPE (2).

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Pour les appareils d’imprimante uniquement, sélectionne la taille du papier à imprimer. Ce membre peut être défini sur zéro si la longueur et la largeur du papier sont toutes deux définies par les membres dmPaperLength et dmPaperWidth . Sinon, le membre dmPaperSize peut être défini sur une valeur spécifique d’appareil supérieure ou égale à DMPAPER_USER ou à l’une des valeurs prédéfinies suivantes.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

Pour les périphériques d’imprimante uniquement, remplace la longueur du papier spécifié par le membre dmPaperSize , soit pour les tailles de papier personnalisées, soit pour les appareils tels que les imprimantes à matrice de points qui peuvent imprimer sur une page de longueur arbitraire. Ces valeurs, ainsi que toutes les autres valeurs de cette structure qui spécifient une longueur physique, sont en dixièmes de millimètre.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

Pour les périphériques d’imprimante uniquement, remplace la largeur du papier spécifié par le membre dmPaperSize .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

Spécifie le facteur par lequel la sortie imprimée doit être mise à l’échelle. La taille de page apparente est mise à l’échelle à partir de la taille de page physique par un facteur dmScale /100. Par exemple, une page de taille de lettre avec une valeur dmScale de 50 contient autant de données qu’une page de 17 pouces par 22 pouces, car le texte de sortie et les graphiques seraient la moitié de leur hauteur et de leur largeur d’origine.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

Sélectionne le nombre de copies imprimées si l’appareil prend en charge plusieurs copies de page.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource

Spécifie la source de papier. Pour récupérer la liste des sources de papier disponibles pour une imprimante, utilisez la fonction DeviceCapabilities avec l’indicateur de DC_BINS.

Ce membre peut être l’une des valeurs suivantes, ou il peut s’agir d’une valeur spécifique à l’appareil supérieure ou égale à DMBIN_USER.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality

Spécifie la résolution de l’imprimante. Il existe quatre valeurs indépendantes de l’appareil prédéfinies :

Si une valeur positive est spécifiée, elle spécifie le nombre de points par pouce (PPP) et dépend donc de l’appareil.

DUMMYUNIONNAME.dmPosition

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition

Pour les appareils d’affichage uniquement, une structure POINTL qui indique les coordonnées positionnelles de l’appareil d’affichage en référence à la zone de bureau. L’appareil d’affichage principal se trouve toujours aux coordonnées (0,0).

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

Pour les appareils d’affichage uniquement, l’orientation à laquelle les images doivent être présentées. Si DM_DISPLAYORIENTATION n’est pas défini, ce membre doit être égal à zéro. Si DM_DISPLAYORIENTATION est défini, ce membre doit être l’une des valeurs suivantes

Pour déterminer si l’orientation de l’affichage est portrait ou paysage, vérifiez le ratio de dmPelsWidth à dmPelsHeight.

Windows 2000 : Non pris en charge.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Pour les appareils d’affichage à résolution fixe uniquement, la façon dont l’affichage présente un mode basse résolution sur un affichage à résolution supérieure. Par exemple, si la résolution d’un appareil d’affichage est fixe à 1 024 x 768 pixels, mais que son mode est défini sur 640 x 480 pixels, l’appareil peut afficher une image de 640 x 480 quelque part dans l’intérieur de l’espace d’écran 1024 x 768 ou étirer l’image 640 x 480 pour remplir l’espace d’écran plus grand. Si DM_DISPLAYFIXEDOUTPUT n’est pas défini, ce membre doit être égal à zéro. Si DM_DISPLAYFIXEDOUTPUT est défini, ce membre doit être l’une des valeurs suivantes.

Windows 2000 : Non pris en charge.

dmColor

Bascule entre la couleur et le monochrome sur les imprimantes de couleur. Les valeurs possibles sont les suivantes :

• DMCOLOR_COLOR
• DMCOLOR_MONOCHROME

dmDuplex

Sélectionne l’impression duplex ou double face pour les imprimantes capables d’imprimer en duplex. Voici les valeurs possibles.

dmYResolution

Spécifie la résolution y, en points par pouce, de l’imprimante. Si l’imprimante initialise ce membre, le membre dmPrintQuality spécifie la résolution x, en points par pouce, de l’imprimante.

dmTTOption

Spécifie comment les polices TrueType doivent être imprimées. Ce membre peut être l’une des valeurs suivantes.

dmCollate

Spécifie si le classement doit être utilisé lors de l’impression de plusieurs copies. (Ce membre est ignoré, sauf si le pilote d’imprimante indique la prise en charge du classement en définissant le membre dmFields sur DM_COLLATE.) Ce membre peut être l’une des valeurs suivantes.

dmFormName[CCHFORMNAME]

Tableau de caractères sans fin qui spécifie le nom du formulaire à utiliser ; par exemple, « Lettre » ou « Juridique ». Un ensemble complet de noms peut être récupéré à l’aide de la fonction EnumForms .

dmLogPixels

Nombre de pixels par pouce logique. Les pilotes d’imprimante n’utilisent pas ce membre.

dmBitsPerPel

Spécifie la résolution de couleurs, en bits par pixel, de l’appareil d’affichage (par exemple : 4 bits pour 16 couleurs, 8 bits pour 256 couleurs ou 16 bits pour 65 536 couleurs). Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.

dmPelsWidth

Spécifie la largeur, en pixels, de l’aire d’appareil visible. Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.

dmPelsHeight

Spécifie la hauteur, en pixels, de l’aire d’appareil visible. Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

Spécifie le mode d’affichage de l’appareil. Ce membre peut être une combinaison des valeurs suivantes.

Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.

DUMMYUNIONNAME2.dmNup

Spécifie l’emplacement où la NUP est effectuée. Il peut s’agir de l’un des éléments suivants.

dmDisplayFrequency

Spécifie la fréquence, en hertz (cycles par seconde), de l’appareil d’affichage en mode particulier. Cette valeur est également appelée taux d’actualisation vertical de l’appareil d’affichage. Les pilotes d’affichage utilisent ce membre. Elle est utilisée, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.

Lorsque vous appelez la fonction EnumDisplaySettings , le membre dmDisplayFrequency peut retourner avec la valeur 0 ou 1. Ces valeurs représentent le taux d’actualisation par défaut du matériel d’affichage. Ce taux par défaut est généralement défini par des commutateurs sur une carte d’affichage ou une carte mère d’ordinateur, ou par un programme de configuration qui n’utilise pas de fonctions d’affichage telles que ChangeDisplaySettings.

dmICMMethod

Spécifie la façon dont ICM est géré. Pour une application non ICM, ce membre détermine si ICM est activé ou désactivé. Pour les applications ICM, le système examine ce membre pour déterminer comment gérer la prise en charge ICM. Ce membre peut être l’une des valeurs prédéfinies suivantes, ou une valeur définie par le pilote supérieure ou égale à la valeur de DMICMMETHOD_USER.

Le pilote d’imprimante doit fournir une interface utilisateur pour définir ce membre. La plupart des pilotes d’imprimante prennent uniquement en charge la valeur DMICMMETHOD_SYSTEM ou DMICMMETHOD_NONE. Les pilotes pour les imprimantes PostScript prennent en charge toutes les valeurs.

dmICMIntent

Spécifie la méthode de correspondance de couleur ou l’intention qui doit être utilisée par défaut. Ce membre est principalement destiné aux applications non ICM. Les applications ICM peuvent établir des intentions à l’aide des fonctions ICM. Ce membre peut être l’une des valeurs prédéfinies suivantes, ou une valeur définie par le pilote supérieure ou égale à la valeur de DMICM_USER.

dmMediaType

Spécifie le type de média en cours d’impression. Le membre peut être l’une des valeurs prédéfinies suivantes, ou une valeur définie par le pilote supérieure ou égale à la valeur de DMMEDIA_USER.

Pour récupérer la liste des types de supports disponibles pour une imprimante, utilisez la fonction DeviceCapabilities avec l’indicateur de DC_MEDIATYPES.

dmDitherType

Spécifie la façon dont le tramage doit être effectué. Le membre peut être l’une des valeurs prédéfinies suivantes, ou une valeur définie par le pilote supérieure ou égale à la valeur de DMDITHER_USER.

dmReserved1

Non utilisé ; doit être égal à zéro.

dmReserved2

Non utilisé ; doit être égal à zéro.

dmPanningWidth

Ce membre doit être égal à zéro.

dmPanningHeight

Ce membre doit être égal à zéro.

Remarques

Les données privées d’un pilote de périphérique suivent la partie publique de la structure DEVMODE . La taille des données publiques peut varier pour différentes versions de la structure. Le membre dmSize spécifie le nombre d’octets de données publiques, et le membre dmDriverExtra spécifie le nombre d’octets de données privées.

Spécifications

Voir aussi

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

DocumentProperties

EnumDisplaySettings

OpenPrinter

structures d’API Print Spooler

Impression