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 périphérique 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 à terminaison zéro 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 tenir dans le 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 sur sizeof (DEVMODE) pour 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 au périphérique, 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 qui conviennent à la technologie d’imprimante ou d’affichage.

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

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation

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

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Pour les périphériques d’imprimante uniquement, sélectionne la taille du papier sur lequel 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 à l’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ée par le membre dmPaperSize , soit pour les formats de papier personnalisés, 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 selon lequel la sortie imprimée doit être mise à l’échelle. La taille de page apparente est mise à l’échelle à partir de la taille de la page physique par un facteur dmScale /100. Par exemple, une page de taille lettre avec une valeur dmScale de 50 contiendrait autant de données qu’une page de 17 par 22 pouces, car le texte et les graphiques de sortie seraient deux fois moins hauts que la largeur d’origine.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

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

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 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 prédéfinies indépendantes de l’appareil :

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, structure POINTL qui indique les coordonnées positionnelles de l’appareil d’affichage en référence à la zone de bureau. Le périphérique d’affichage principal se trouve toujours aux coordonnées (0,0).

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

Pour les appareils d’affichage uniquement, 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, case activée le rapport dmPelsWidth surdmPelsHeight.

Windows 2000 : Non pris en charge.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Pour les appareils d’affichage à résolution fixe uniquement, comment l’affichage présente un mode basse résolution sur un écran à résolution plus élevée. Par exemple, si la résolution d’un périphérique d’affichage est fixée à 1024 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 à l’intérieur de l’espace d’écran 1024 x 768 ou étirer l’image de 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 couleur. Les valeurs possibles sont les suivantes :

• DMCOLOR_COLOR
• DMCOLOR_MONOCHROME

dmDuplex

Sélectionne l’impression recto-verso ou recto-verso pour les imprimantes capables d’impression recto verso. 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 la façon dont 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, « Letter » ou « Legal ». 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 des 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 la surface visible de l’appareil. 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 la surface visible de l’appareil. 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ù le NUP est effectué. 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 dans un mode particulier. Cette valeur est également appelée taux d’actualisation verticale de l’appareil d’affichage. Les pilotes d’affichage utilisent ce membre. Il est utilisé, 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 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 un écran carte 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 DC_MEDIATYPES.

dmDitherType

Spécifie la façon dont le dithering 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 selon les 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.

Configuration requise

Voir aussi

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

DocumentProperties

EnumDisplaySettings

OpenPrinter

Imprimer les structures de l’API spouleur

Impression