DEVMODEA-Struktur (wingdi.h)

Die DEVMODE-Datenstruktur enthält Informationen zur Initialisierung und Umgebung eines Druckers oder 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;

Member

dmDeviceName[CCHDEVICENAME]

Ein Nullzeichenarray, das den Anzeigenamen des Druckers oder Displays angibt; beispielsweise "PCL/HP LaserJet" im Fall von PCL/HP LaserJet. Diese Zeichenfolge ist für Gerätetreiber eindeutig. Beachten Sie, dass dieser Name möglicherweise abgeschnitten wird, um in das Array dmDeviceName zu passen.

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, wobei keine privaten treiberspezifischen Daten enthalten sind, die den öffentlichen Membern der Struktur folgen könnten. Legen Sie diesen Member auf fest sizeof (DEVMODE) , 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 diesen Member auf Null fest.

dmFields

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

Die folgenden Werte sind definiert und werden hier mit den entsprechenden Strukturelementen aufgelistet.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation

Wählt nur für Druckergeräte die Ausrichtung des Papiers aus. Dieses Element kann entweder DMORIENT_PORTRAIT (1) oder DMORIENT_LANDSCAPE (2) sein.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Wählt nur für Druckergeräte die Größe des Papiers aus, auf dem gedruckt werden soll. Dieses Element kann auf 0 festgelegt werden, wenn die Länge und Breite des Papiers sowohl durch die Elemente dmPaperLength als auch dmPaperWidth festgelegt werden. Andernfalls kann der dmPaperSize-Member auf einen gerätespezifischen Wert festgelegt werden, der größer als oder gleich DMPAPER_USER ist, oder auf einen der folgenden vordefinierten Werte.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

Nur für Druckergeräte überschreibt die Länge des Papiers, das vom dmPaperSize-Element angegeben wird, entweder für benutzerdefinierte Papiergrößen oder für Geräte wie Z. B. Matrixdrucker, die auf einer Seite mit beliebiger Länge drucken können. Diese Werte liegen zusammen mit allen anderen Werten in dieser Struktur, die eine physische Länge angeben, in Zehntelmillimetern.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

Nur für Druckergeräte überschreibt die vom dmPaperSize-Element angegebene Breite des Papiers.

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 den Faktor dmScale /100 skaliert. Beispielsweise würde eine Seite im Buchstabenformat mit einem dmScale-Wert von 50 so viele Daten enthalten wie eine Seite von 17 x 22 Zoll, da der Ausgabetext und die Grafiken die Hälfte ihrer ursprünglichen Höhe und Breite aufweisen würden.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

Wählt die Anzahl der gedruckten Kopien aus, wenn das Gerät mehrseitige Kopien 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 dem flag DC_BINS.

Bei diesem Member kann es sich um einen der folgenden Werte oder um einen gerätespezifischen Wert handeln, der größer als 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 eine POINTL-Struktur , 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

Nur bei Anzeigegeräten die Ausrichtung, in der Bilder angezeigt werden sollen. Wenn DM_DISPLAYORIENTATION nicht festgelegt ist, muss dieses Element 0 sein. Wenn DM_DISPLAYORIENTATION festgelegt ist, muss dieser Member einer der folgenden Werte sein

Überprüfen Sie das Verhältnis von dmPelsWidth zu dmPelsHeight, um zu bestimmen, ob die Anzeigeausrichtung hoch- oder quer ausgerichtet ist.

Windows 2000: Nicht unterstützt.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Nur bei Geräten mit fester Auflösung zeigt das Display einen Modus mit niedriger Auflösung auf einem Display mit höherer Auflösung an. Wenn die Auflösung eines Anzeigegeräts beispielsweise auf 1024 x 768 Pixel festgelegt ist, sein Modus jedoch auf 640 x 480 Pixel festgelegt ist, kann das Gerät entweder ein Bild von 640 x 480 pixeln irgendwo im Inneren des 1024 x 768-Bildschirmraums anzeigen oder das 640 x 480-Bild strecken, um den größeren Bildschirmraum zu füllen. Wenn DM_DISPLAYFIXEDOUTPUT nicht festgelegt ist, muss dieses Element 0 sein. Wenn DM_DISPLAYFIXEDOUTPUT festgelegt ist, muss dieser Member einer der folgenden Werte sein.

Windows 2000: Nicht unterstützt.

dmColor

Wechselt zwischen Farbe und Monochrom auf Farbdruckern. Folgende Werte sind möglich:

• DMCOLOR_COLOR
• DMCOLOR_MONOCHROME

dmDuplex

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

dmYResolution

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

dmTTOption

Gibt an, wie TrueType-Schriftarten gedruckt werden sollen. Dieser Member kann einer der folgenden Werte sein.

dmCollate

Gibt an, ob die Sortierung beim Drucken mehrerer Kopien verwendet werden soll. (Dieser Member wird ignoriert, es sei denn, der Druckertreiber gibt die Unterstützung für sortierung an, indem er den dmFields-Member auf DM_COLLATE festlegt.) Dieser Member kann einer der folgenden Werte sein.

dmFormName[CCHFORMNAME]

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

dmLogPixels

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

dmBitsPerPel

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

dmPelsWidth

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

dmPelsHeight

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

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

Gibt den Anzeigemodus des Geräts an. Dieser Member kann eine Kombination der folgenden Werte sein.

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

DUMMYUNIONNAME2.dmNup

Gibt an, wo die NUP ausgeführt wird. Dies kann einer der folgenden Sein:

dmDisplayFrequency

Gibt die Frequenz des Anzeigegeräts in einem bestimmten Modus in Hertz (Zyklen pro Sekunde) an. Dieser Wert wird auch als vertikale Aktualisierungsrate des Anzeigegeräts bezeichnet. Anzeigetreiber verwenden dieses Element. Sie wird beispielsweise in der ChangeDisplaySettings-Funktion verwendet. Druckertreiber verwenden dieses Element nicht.

Wenn Sie die EnumDisplaySettings-Funktion aufrufen, gibt der dmDisplayFrequency-Member möglicherweise den Wert 0 oder 1 zurück. Diese Werte stellen die Standardaktualisierungsrate der Anzeigehardware dar. Diese Standardrate wird in der Regel durch Schalter auf einer Anzeige Karte- oder Computerplatine oder durch ein Konfigurationsprogramm festgelegt, das keine Anzeigefunktionen wie ChangeDisplaySettings verwendet.

dmICMMethod

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

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

dmICMIntent

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

dmMediaType

Gibt den Typ der Medien an, auf die gedruckt wird. Der Member kann einer der folgenden vordefinierten Werte oder ein vom Treiber definierter Wert sein, der größer oder gleich dem Wert von DMMEDIA_USER ist.

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

dmDitherType

Gibt an, wie dithering ausgeführt werden soll. Der Member kann einer der folgenden vordefinierten Werte oder ein vom Treiber definierter Wert sein, der größer oder gleich dem Wert von DMDITHER_USER ist.

dmReserved1

Nicht verwendet; muss null sein.

dmReserved2

Nicht verwendet; muss null sein.

dmPanningWidth

Dieser Member muss 0 sein.

dmPanningHeight

Dieser Member muss 0 sein.

Hinweise

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

Anforderungen

Weitere Informationen

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

Documentproperties

EnumDisplaySettings

OpenPrinter

Drucken von Spooler-API-Strukturen

Drucken