Freigeben über


DEVMODEA-Struktur (wingdi.h)

Die DEVMODE- Datenstruktur enthält Informationen zur Initialisierung und Umgebung eines Druckers oder eines Anzeigegeräts.

Syntax

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;

Angehörige

dmDeviceName[CCHDEVICENAME]

Ein 0-gekündigtes Zeichenarray, das den "Anzeigenamen" des Druckers oder der Anzeige angibt; Beispiel: "PCL/HP LaserJet" im Fall von PCL/HP LaserJet. Diese Zeichenfolge ist unter Gerätetreibern eindeutig. Beachten Sie, dass dieser Name möglicherweise abgeschnitten wird, damit er in das dmDeviceName Array passt.

dmSpecVersion

Die Versionsnummer der Initialisierungsdatenspezifikation, auf der die Struktur basiert. Um sicherzustellen, dass die richtige Version für jedes Betriebssystem verwendet wird, verwenden Sie DM_SPECVERSION.

dmDriverVersion

Die vom Treiberentwickler zugewiesene Treiberversionsnummer.

dmSize

Gibt die Größe der DEVMODE--Struktur in Bytes an, einschließlich privater treiberspezifischer Daten, die den öffentlichen Membern der Struktur folgen können. Legen Sie dieses Element auf sizeof (DEVMODE) fest, um die Version der verwendeten DEVMODE- Struktur anzugeben.

dmDriverExtra

Enthält die Anzahl der Bytes privater Treiberdaten, die dieser Struktur folgen. Wenn ein Gerätetreiber keine gerätespezifischen Informationen verwendet, legen Sie dieses Element auf Null fest.

dmFields

Gibt an, ob bestimmte Elemente der DEVMODE--Struktur initialisiert wurden. Wenn ein Element initialisiert wird, wird das entsprechende Bit festgelegt, andernfalls ist das Bit klar. Ein Treiber unterstützt nur die DEVMODE- Member, die für die Drucker- oder Anzeigetechnologie geeignet sind.

Die folgenden Werte sind definiert und werden hier mit den entsprechenden Strukturelementen aufgeführt.

Wert Strukturelement
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

Bei Druckergeräten wird nur die Ausrichtung des Papiers ausgewählt. Dieses Element kann entweder DMORIENT_PORTRAIT (1) oder DMORIENT_LANDSCAPE (2) sein.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Bei Druckergeräten wird nur das Papierformat ausgewählt, auf dem gedruckt werden soll. Dieses Element kann auf Null festgelegt werden, wenn sowohl die Länge als auch die Breite des Papiers durch die dmPaperLength- und dmPaperWidth Member festgelegt werden. Andernfalls kann die dmPaperSize Member auf einen gerätespezifischen Wert festgelegt werden, der größer oder gleich DMPAPER_USER oder einem der folgenden vordefinierten Werte ist.

Wert Bedeutung
DMPAPER_LETTER Brief, 8 1/2 - um 11 Zoll
DMPAPER_LEGAL Legal, 8 1/2- bis 14 Zoll
DMPAPER_9X11 9- bis 11-Zoll-Blatt
DMPAPER_10X11 10- bis 11-Zoll-Blatt
DMPAPER_10X14 10- bis 14-Zoll-Blatt
DMPAPER_15X11 15- bis 11-Zoll-Blatt
DMPAPER_11X17 11- bis 17-Zoll-Blatt
DMPAPER_12X11 12- bis 11 Zoll Blatt
DMPAPER_A2 A2 Blatt, 420 x 594 Millimeter
DMPAPER_A3 A3 Blatt, 297- bis 420 Millimeter
DMPAPER_A3_EXTRA A3 Extra 322 x 445 Millimeter
DMPAPER_A3_EXTRA_TRAVERSE A3 Extra Transverse 322 x 445 Millimeter
DMPAPER_A3_ROTATED A3 gedrehtes Blatt, 420 - bis 297 Millimeter
DMPAPER_A3_TRAVERSE A3 Transverse 297 x 420-Millimeter
DMPAPER_A4 A4 Blatt, 210 - bis 297 Millimeter
DMPAPER_A4_EXTRA A4 Blatt, 9,27 x 12,69 Zoll
DMPAPER_A4_PLUS A4 Plus 210 x 330 Millimeter
DMPAPER_A4_ROTATED A4 gedrehtes Blatt, 297- bis 210 Millimeter
DMPAPER_A4SMALL A4 kleines Blatt, 210- bis 297 Millimeter
DMPAPER_A4_TRANSVERSE A4 Transverse 210 x 297 Millimeter
DMPAPER_A5 A5 Blatt, 148- bis 210 Millimeter
DMPAPER_A5_EXTRA A5 Extra 174 x 235 Millimeter
DMPAPER_A5_ROTATED A5 gedrehtes Blatt, 210- bis 148 Millimeter
DMPAPER_A5_TRANSVERSE A5 Transverse 148 x 210 Millimeter
DMPAPER_A6 A6 Blatt, 105- bis 148 Millimeter
DMPAPER_A6_ROTATED A6 gedrehtes Blatt, 148- bis 105-Millimeter
DMPAPER_A_PLUS SuperA/A4 227 x 356 -millimeters
DMPAPER_B4 B4 Blatt, 250- bis 354 Millimeter
DMPAPER_B4_JIS_ROTATED B4 (JIS) gedrehtes Blatt, 364- bis 257 Millimeter
DMPAPER_B5 B5 Blatt, 182- bis 257-Millimeter-Papier
DMPAPER_B5_EXTRA B5 (ISO) Extra 201 x 276 Millimeter
DMPAPER_B5_JIS_ROTATED B5 (JIS) gedrehtes Blatt, 257- bis 182 Millimeter
DMPAPER_B6_JIS B6 (JIS)-Blatt, 128- bis 182 Millimeter
DMPAPER_B6_JIS_ROTATED B6 (JIS) gedrehtes Blatt, 182- bis 128 Millimeter
DMPAPER_B_PLUS SuperB/A3 305 x 487 Millimeter
DMPAPER_CSHEET C Blatt, 17- bis 22 Zoll
DMPAPER_DBL_JAPANESE_POSTCARD Doppelte japanische Postkarte, 200 - bis 148 Millimeter
DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED Doppelt japanische Postkarte gedreht, 148- bis 200 Millimeter
DMPAPER_DSHEET D Blatt, 22- bis 34 Zoll
DMPAPER_ENV_9 #9 Briefumschlag, 3 7/8- bis 8 7/8 Zoll
DMPAPER_ENV_10 #10 Briefumschlag, 4 1/8- bis 9 1/2 Zoll
DMPAPER_ENV_11 #11 Briefumschlag, 4 1/2- bis 10 3/8 Zoll
DMPAPER_ENV_12 #12 Briefumschlag, 4 3/4- bis 11 Zoll
DMPAPER_ENV_14 #14 Briefumschlag, 5- bis 11 1/2 Zoll
DMPAPER_ENV_C5 C5 Envelope, 162- bis 229 Millimeter
DMPAPER_ENV_C3 C3 Envelope, 324- bis 458 Millimeter
DMPAPER_ENV_C4 C4 Envelope, 229- bis 324 Millimeter
DMPAPER_ENV_C6 C6 Envelope, 114- bis 162 Millimeter
DMPAPER_ENV_C65 C65 Envelope, 114- bis 229 Millimeter
DMPAPER_ENV_B4 B4 Envelope, 250- bis 353 Millimeter
DMPAPER_ENV_B5 B5 Envelope, 176- bis 250 Millimeter
DMPAPER_ENV_B6 B6 Envelope, 176- bis 125 Millimeter
DMPAPER_ENV_DL DL Envelope, 110- bis 220 Millimeter
DMPAPER_ENV_INVITE Briefumschlag Einladung 220 x 220 mm
DMPAPER_ENV_ITALY Italien Envelope, 110- bis 230 Millimeter
DMPAPER_ENV_MONARCH Monarch Envelope, 3 7/8 - um 7 1/2 Zoll
DMPAPER_ENV_PERSONAL 6 3/4 Briefumschlag, 3 5/8- bis 6 1/2 Zoll
DMPAPER_ESHEET E Sheet, 34- bis 44 Zoll
DMPAPER_EXECUTIVE Executive, 7 1/4 - um 10 1/2 Zoll
DMPAPER_FANFOLD_US US Std Fanfold, 14 7/8- bis 11 Zoll
DMPAPER_FANFOLD_STD_GERMAN Deutsch Std Fanfold, 8 1/2- bis 12 Zoll
DMPAPER_FANFOLD_LGL_GERMAN Deutsch Legal Fanfold, 8 - um 13 Zoll
DMPAPER_FOLIO Folio, 8 1/2- bis 13 Zoll Papier
DMPAPER_ISO_B4 B4 (ISO) 250- bis 353 Millimeter Papier
DMPAPER_JAPANESE_POSTCARD Japanische Postkarte, 100 bis 148 Millimeter
DMPAPER_JAPANESE_POSTCARD_ROTATED Japanische Postkarte gedreht, 148- um 100 Millimeter
DMPAPER_JENV_CHOU3 Japanischer Umschlag Chou #3
DMPAPER_JENV_CHOU3_ROTATED Japanischer Umschlag Chou #3 gedreht
DMPAPER_JENV_CHOU4 Japanischer Umschlag Chou #4
DMPAPER_JENV_CHOU4_ROTATED Japanischer Umschlag Chou #4 gedreht
DMPAPER_JENV_KAKU2 Japanischer Umschlag Kaku #2
DMPAPER_JENV_KAKU2_ROTATED Japanischer Umschlag Kaku #2 gedreht
DMPAPER_JENV_KAKU3 Japanischer Umschlag Kaku #3
DMPAPER_JENV_KAKU3_ROTATED Japanischer Umschlag Kaku #3 gedreht
DMPAPER_JENV_YOU4 Japanischer Umschlag Sie #4
DMPAPER_JENV_YOU4_ROTATED Japanischer Umschlag Sie #4 gedreht
DMPAPER_LAST DMPAPER_PENV_10_ROTATED
DMPAPER_LEDGER Ledger, 17- bis 11 Zoll
DMPAPER_LEGAL_EXTRA Legal Extra 9 1/2 x 15 Zoll.
DMPAPER_LETTER_EXTRA Letter Extra 9 1/2 x 12 Zoll.
DMPAPER_LETTER_EXTRA_TRANSVERSE Letter Extra Transverse 9 1/2 x 12 Zoll.
DMPAPER_LETTER_ROTATED Buchstabe gedreht 11 x 8 1/2 Zoll
DMPAPER_LETTERSMALL Buchstabe Klein, 8 1/2 - um 11 Zoll
DMPAPER_LETTER_TRANSVERSE Letter Transverse 8 1/2 x 11 Zoll
DMPAPER_NOTE Hinweis: 8 1/2- bis 11 Zoll
DMPAPER_P16K PRC 16K, 146- bis 215 Millimeter
DMPAPER_P16K_ROTATED PRC 16K gedreht, 215- bis 146 Millimeter
DMPAPER_P32K PRC 32K, 97- bis 151-Millimeter
DMPAPER_P32K_ROTATED PRC 32K gedreht, 151- bis 97 Millimeter
DMPAPER_P32KBIG PRC 32K(Big) 97- bis 151-Millimeter
DMPAPER_P32KBIG_ROTATED PRC 32K(Groß) gedreht, 151- bis 97 Millimeter
DMPAPER_PENV_1 PRC Envelope Nr. 1, 102- bis 165 Millimeter
DMPAPER_PENV_1_ROTATED PRC Envelope Nr. 1 gedreht, 165- bis 102 Millimeter
DMPAPER_PENV_2 PRC Envelope #2, 102- bis 176 Millimeter
DMPAPER_PENV_2_ROTATED PRC Envelope Nr. 2 Gedreht, 176- bis 102-Millimeter
DMPAPER_PENV_3 PRC Envelope #3, 125- bis 176 Millimeter
DMPAPER_PENV_3_ROTATED PRC Envelope Nr. 3 gedreht, 176- bis 125 Millimeter
DMPAPER_PENV_4 PRC Envelope #4, 110- bis 208-Millimeter
DMPAPER_PENV_4_ROTATED PRC Envelope #4 Gedreht, 208- um 110 Millimeter
DMPAPER_PENV_5 PRC Envelope #5, 110- bis 220 Millimeter
DMPAPER_PENV_5_ROTATED PRC Envelope Nr. 5 gedreht, 220 - um 110 Millimeter
DMPAPER_PENV_6 PRC Envelope #6, 120- bis 230 Millimeter
DMPAPER_PENV_6_ROTATED PRC Envelope Nr. 6 gedreht, 230- bis 120 Millimeter
DMPAPER_PENV_7 PRC Envelope #7, 160- bis 230 Millimeter
DMPAPER_PENV_7_ROTATED PRC Envelope Nr. 7 Gedreht, 230- um 160 Millimeter
DMPAPER_PENV_8 PRC Envelope #8, 120- bis 309-Millimeter
DMPAPER_PENV_8_ROTATED PRC Envelope Nr. 8 gedreht, 309- bis 120 Millimeter
DMPAPER_PENV_9 PRC Envelope Nr. 9, 229- bis 324 Millimeter
DMPAPER_PENV_9_ROTATED PRC Envelope Nr. 9 gedreht, 324- bis 229 Millimeter
DMPAPER_PENV_10 PRC Envelope #10, 324- bis 458 Millimeter
DMPAPER_PENV_10_ROTATED PRC Envelope #10 Gedreht, 458- bis 324 Millimeter
DMPAPER_QUARTO Quarto, 215- bis 275-Millimeter-Papier
DMPAPER_STATEMENT Anweisung, 5 1/2- bis 8 1/2 Zoll
DMPAPER_TABLOID Tabloid, 11- bis 17 Zoll
DMPAPER_TABLOID_EXTRA Tabloid, 11,69 x 18 Zoll

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

Setzt für Druckergeräte nur die Länge des papiers außer Kraft, das durch die dmPaperSize Member angegeben wird, entweder für benutzerdefinierte Papierformate oder für Geräte wie Punktmatrixdrucker, die auf einer Seite beliebiger Länge drucken können. Diese Werte sind zusammen mit allen anderen Werten in dieser Struktur, die eine physische Länge angeben, zehntel eines Millimeters.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

Setzt für Druckergeräte nur die Breite des papiers außer Kraft, das durch das dmPaperSize Member angegeben ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

Gibt den Faktor an, um den die gedruckte Ausgabe skaliert werden soll. Die scheinbare Seitengröße wird von der physischen Seitengröße um einen Faktor dmScale /100 skaliert. Beispielsweise würde ein Zeichenblatt mit einem dmScale- Wert von 50 so viele Daten wie eine Seite von 17 bis 22 Zoll enthalten, da der Ausgabetext und die Grafik die Hälfte ihrer ursprünglichen Höhe und Breite betragen würden.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

Wählt die Anzahl der gedruckten Kopien aus, wenn das Gerät kopien mit mehreren Seiten unterstützt.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource

Gibt die Papierquelle an. Um eine Liste der verfügbaren Papierquellen für einen Drucker abzurufen, verwenden Sie die DeviceCapabilities--Funktion mit der DC_BINS-Kennzeichnung.

Bei diesem Element kann es sich um einen der folgenden Werte handeln, oder es kann sich um einen gerätespezifischen Wert handeln, der größer oder gleich DMBIN_USER ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality

Gibt die Druckerauflösung an. Es gibt vier vordefinierte geräteunabhängige Werte:

Wenn ein positiver Wert angegeben wird, gibt er die Anzahl der Punkte pro Zoll (DPI) an und ist daher geräteabhängig.

DUMMYUNIONNAME.dmPosition

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition

Nur für Anzeigegeräte gibt eine POINTL- Struktur an, die die Positionskoordinaten des Anzeigegeräts in Bezug auf den Desktopbereich angibt. Das primäre Anzeigegerät befindet sich immer an Koordinaten (0,0).

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

Bei Anzeigegeräten sollte nur die Ausrichtung, an der Bilder präsentiert werden sollen. Wenn DM_DISPLAYORIENTATION nicht festgelegt ist, muss dieses Element null sein. Wenn DM_DISPLAYORIENTATION festgelegt ist, muss dieses Element einer der folgenden Werte sein:

Wert Bedeutung
DMDO_DEFAULT Die Bildschirmausrichtung ist die natürliche Ausrichtung des Anzeigegeräts. sie sollte als Standard verwendet werden.
DMDO_90 Die Anzeigeausrichtung wird um 90 Grad (im Uhrzeigersinn) von DMDO_DEFAULT gedreht.
DMDO_180 Die Anzeigeausrichtung wird um 180 Grad (im Uhrzeigersinn) von DMDO_DEFAULT gedreht.
DMDO_270 Die Anzeigeausrichtung wird um 270 Grad (im Uhrzeigersinn) von DMDO_DEFAULT gedreht.
 

Um zu bestimmen, ob die Anzeigeausrichtung hoch- oder querformatiert ist, überprüfen Sie das Verhältnis von dmPelsWidth zu dmPelsHeight-.

Windows 2000: Nicht unterstützt.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Bei Geräten mit fester Auflösung wird nur die Darstellung eines Modus mit niedriger Auflösung auf einer Anzeige mit höherer Auflösung dargestellt. Wenn die Auflösung eines Anzeigegeräts beispielsweise auf 1024 x 768 Pixel festgelegt ist, der Modus jedoch auf 640 x 480 Pixel festgelegt ist, kann das Gerät entweder ein 640 x 480-Bild irgendwo im Inneren des Bildschirmbereichs von 1024 x 768 anzeigen oder das 640 x 480 Bild strecken, um den größeren Bildschirmbereich zu füllen. Wenn DM_DISPLAYFIXEDOUTPUT nicht festgelegt ist, muss dieses Element null sein. Wenn DM_DISPLAYFIXEDOUTPUT festgelegt ist, muss dieses Element einen der folgenden Werte aufweisen.

Wert Bedeutung
DMDFO_DEFAULT Die Standardeinstellung der Anzeige.
DMDFO_CENTER Das Bild mit niedriger Auflösung wird im größeren Bildschirmbereich zentriert.
DMDFO_STRETCH Das Bild mit niedriger Auflösung wird gestreckt, um den größeren Bildschirmbereich auszufüllen.
 

Windows 2000: Nicht unterstützt.

dmColor

Wechselt zwischen Farbe und Monochrom auf Farbdruckern. Im Folgenden sind die möglichen Werte aufgeführt:

  • DMCOLOR_COLOR
  • DMCOLOR_MONOCHROME

dmDuplex

Wählt duplex- oder doppelseitigen Druck für Drucker aus, die duplexdruckfähig sind. Nachfolgend sind die möglichen Werte aufgeführt.

Wert Bedeutung
DMDUP_SIMPLEX Normaldruck (nichtduplex).
DMDUP_HORIZONTAL Kurzrandbindung, d. h. der lange Rand der Seite, ist horizontal.
DMDUP_VERTICAL Lange Kantenbindung, d. h. der lange Rand der Seite, ist vertikal.

dmYResolution

Gibt die y-Auflösung (in Punkten pro Zoll) des Druckers an. Wenn der Drucker dieses Element initialisiert, gibt das dmPrintQuality Member die x-Auflösung (in Punkt pro Zoll) des Druckers an.

dmTTOption

Gibt an, wie TrueType-Schriftarten gedruckt werden sollen. Dieses Element kann einer der folgenden Werte sein:

Wert Bedeutung
DMTT_BITMAP Druckt TrueType-Schriftarten als Grafiken. Dies ist die Standardaktion für Punktmatrixdrucker.
DMTT_DOWNLOAD Lädt TrueType-Schriftarten als weiche Schriftarten herunter. Dies ist die Standardaktion für Hewlett-Packard Drucker, die Druckersteuerungssprache (PRINTER Control Language, PCL) verwenden.
DMTT_DOWNLOAD_OUTLINE Lädt TrueType-Schriftarten als weiche Gliederungsschriftarten herunter.
DMTT_SUBDEV Ersetzt Geräteschriftarten für TrueType-Schriftarten. Dies ist die Standardaktion für PostScript-Drucker.

dmCollate

Gibt an, ob beim Drucken mehrerer Kopien Sortierung verwendet werden soll. (Dieses Element wird ignoriert, es sei denn, der Druckertreiber gibt die Unterstützung für die Sortierung an, indem das dmFields-element auf DM_COLLATE festgelegt wird.) Dieses Element kann einer der folgenden Werte sein:

Wert Bedeutung
DMCOLLATE_TRUE Sortieren Sie beim Drucken mehrerer Kopien.
DMCOLLATE_FALSE Beim Drucken mehrerer Kopien nicht sortieren.

dmFormName[CCHFORMNAME]

Ein 0-gekündigtes Zeichenarray, das den Namen des zu verwendenden Formulars angibt; z. B. "Letter" oder "Legal". Ein vollständiger Satz von Namen kann mithilfe der funktion EnumForms abgerufen werden.

dmLogPixels

Die Anzahl der Pixel pro logischem Zoll. Druckertreiber verwenden dieses Mitglied nicht.

dmBitsPerPel

Gibt die Farbauflösung in Bits pro Pixel des Anzeigegeräts an (z. B. 4 Bit für 16 Farben, 8 Bit für 256 Farben oder 16 Bit für 65.536 Farben). Anzeigetreiber verwenden dieses Element z. B. in der ChangeDisplaySettings--Funktion. Druckertreiber verwenden dieses Mitglied nicht.

dmPelsWidth

Gibt die Breite der sichtbaren Geräteoberfläche in Pixel an. Anzeigetreiber verwenden dieses Element z. B. in der ChangeDisplaySettings--Funktion. Druckertreiber verwenden dieses Mitglied nicht.

dmPelsHeight

Gibt die Höhe der sichtbaren Geräteoberfläche in Pixel an. Anzeigetreiber verwenden dieses Element z. B. in der ChangeDisplaySettings--Funktion. Druckertreiber verwenden dieses Mitglied nicht.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

Gibt den Anzeigemodus des Geräts an. Dieses Element kann eine Kombination aus den folgenden Werten sein.

Wert Bedeutung
DM_GRAYSCALE Gibt an, dass es sich bei der Anzeige um ein nicht einfarbiges Gerät handelt. Wenn dieses Kennzeichen nicht festgelegt ist, wird die Farbe angenommen. Dieses Kennzeichen ist nicht mehr gültig.
DM_INTERLACED Gibt an, dass der Anzeigemodus interlaced ist. Wenn das Kennzeichen nicht festgelegt ist, wird nicht interlaced angenommen.
 

Anzeigetreiber verwenden dieses Element z. B. in der ChangeDisplaySettings--Funktion. Druckertreiber verwenden dieses Mitglied nicht.

DUMMYUNIONNAME2.dmNup

Gibt an, wo die NUP abgeschlossen ist. Dies kann eine der folgenden Sein:

Wert Bedeutung
DMNUP_SYSTEM Der Druckspooler führt die NUP aus.
DMNUP_ONEUP Die Anwendung führt die NUP aus.

dmDisplayFrequency

Gibt die Frequenz in Hertz (Zyklen pro Sekunde) des Anzeigegeräts in einem bestimmten Modus an. Dieser Wert wird auch als vertikale Aktualisierungsrate des Anzeigegeräts bezeichnet. Anzeigen von Treibern, die dieses Mitglied verwenden. Sie wird z. B. in der ChangeDisplaySettings-Funktion verwendet. Druckertreiber verwenden dieses Mitglied nicht.

Wenn Sie die EnumDisplaySettings--Funktion aufrufen, kann das dmDisplayFrequency Member mit dem Wert 0 oder 1 zurückgeben. Diese Werte stellen die Standardaktualisierungsrate der Anzeigehardware dar. Diese Standardrate wird in der Regel durch Schalter auf einer Grafikkarte oder einer Computerplatine oder durch ein Konfigurationsprogramm festgelegt, das keine Anzeigefunktionen wie ChangeDisplaySettingsverwendet.

dmICMMethod

Gibt an, wie ICM verarbeitet wird. Bei einer Nicht-ICM-Anwendung bestimmt dieser Member, ob ICM aktiviert oder deaktiviert ist. Bei ICM-Anwendungen untersucht das System dieses Mitglied, um zu bestimmen, wie die ICM-Unterstützung behandelt wird. Bei diesem Element kann es sich um einen der folgenden vordefinierten Werte oder um einen treiberdefinierten Wert handeln, der größer oder gleich dem Wert von DMICMMETHOD_USER ist.

Wert Bedeutung
DMICMMETHOD_NONE Gibt an, dass ICM deaktiviert ist.
DMICMMETHOD_SYSTEM Gibt an, dass ICM von Windows behandelt wird.
DMICMMETHOD_DRIVER Gibt an, dass ICM vom Gerätetreiber behandelt wird.
DMICMMETHOD_DEVICE Gibt an, dass ICM vom Zielgerät behandelt wird.
 

Der Druckertreiber muss eine Benutzeroberfläche zum Festlegen dieses Mitglieds bereitstellen. Die meisten Druckertreiber unterstützen nur den wert DMICMMETHOD_SYSTEM oder DMICMMETHOD_NONE. Treiber für PostScript-Drucker unterstützen alle Werte.

dmICMIntent

Gibt an, welche Farbabgleichsmethode oder -absicht standardmäßig verwendet werden soll. Dieses Mitglied ist in erster Linie für Nicht-ICM-Anwendungen vorgesehen. ICM-Anwendungen können Absichten mithilfe der ICM-Funktionen einrichten. Bei diesem Element kann es sich um einen der folgenden vordefinierten Werte oder um einen treiber definierten Wert handeln, der größer oder gleich dem Wert von DMICM_USER ist.

Wert Bedeutung
DMICM_ABS_COLORIMETRIC Der Farbabgleich sollte optimiert werden, um die genaue Farbe abzugleichen, die ohne Zuordnung mit weißem Punkt angefordert wird. Dieser Wert eignet sich am besten für die Verwendung mit korrekturhilfen.
DMICM_COLORIMETRIC Der Farbabgleich sollte optimiert werden, um die gewünschte Farbe zu ermitteln. Dieser Wert eignet sich am besten für die Verwendung mit Geschäftslogos oder anderen Bildern, wenn eine genaue Farbzuordnung gewünscht wird.
DMICM_CONTRAST Der Farbabgleich sollte für den Farbkontrast optimiert werden. Dieser Wert ist die am besten geeignete Wahl für gescannte oder fotografische Bilder, wenn dithering gewünscht wird.
DMICM_SATURATE Der Farbabgleich sollte für die Farbsättigung optimiert werden. Dieser Wert ist die am besten geeignete Wahl für Geschäftsdiagramme, wenn dithering nicht gewünscht wird.

dmMediaType

Gibt den Typ der Medien an, auf die gedruckt wird. Das Element kann einer der folgenden vordefinierten Werte oder ein treiberdefinierter Wert sein, der größer oder gleich dem Wert von DMMEDIA_USER ist.

Wert Bedeutung
DMMEDIA_STANDARD Normalpapier.
DMMEDIA_GLOSSY Glänzendes Papier.
DMMEDIA_TRANSPARENCY Transparenter Film.
 

Um eine Liste der verfügbaren Medientypen für einen Drucker abzurufen, verwenden Sie die DeviceCapabilities--Funktion mit der DC_MEDIATYPES-Kennzeichnung.

dmDitherType

Gibt an, wie dithering durchgeführt werden soll. Das Element kann einer der folgenden vordefinierten Werte oder ein treiberdefinierter Wert sein, der größer oder gleich dem Wert von DMDITHER_USER ist.

Wert Bedeutung
DMDITHER_NONE Kein Dithering.
DMDITHER_COARSE Dithering mit einem groben Pinsel.
DMDITHER_FINE Dithering mit einem feinen Pinsel.
DMDITHER_LINEART Linienart-Dithering, eine spezielle Dithering-Methode, die definierte Rahmen zwischen Schwarz, Weiß und Grau erzeugt. Es eignet sich nicht für Bilder, die kontinuierliche Graduierungen in Intensität und Farbton enthalten, z. B. gescannte Fotos.
DMDITHER_GRAYSCALE Das Gerät hat graue Skalierung.

dmReserved1

Nicht verwendet; muss null sein.

dmReserved2

Nicht verwendet; muss null sein.

dmPanningWidth

Dieses Element muss null sein.

dmPanningHeight

Dieses Element muss null sein.

Bemerkungen

Die privaten Daten eines Gerätetreibers folgen dem öffentlichen Teil der DEVMODE- Struktur. Die Größe der öffentlichen Daten kann für unterschiedliche Versionen der Struktur variieren. Der dmSize Member gibt die Anzahl der Byte öffentlicher Daten an, und das dmDriverExtra Member gibt die Anzahl der Byte privater Daten an.

Anmerkung

Der wingdi.h-Header definiert DEVMODE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Header- wingdi.h (enthalten Windows.h)

Siehe auch

AdvancedDocumentProperties-

ChangeDisplaySettings

CreateDC-

CreateIC-

DeviceCapabilities-

DocumentProperties-

EnumDisplaySettings

OpenPrinter-

Drucken