ATTRIBUTE_INFO_4-Struktur (winsplp.h)

Die ATTRIBUTE_INFO_4-Struktur wird als Parameter für die DrvQueryJobAttributes-Funktion einer Druckerschnittstellen-DLL verwendet. Alle Memberwerte werden funktionsseitig bereitgestellt. Diese Struktur ähnelt ATTRIBUTE_INFO_3, enthält jedoch zusätzliche Member, um den Druck von N-Up, Duplex und Broschüren sowie die Skalierung zu steuern.

Syntax

typedef struct _ATTRIBUTE_INFO_4 {
  DWORD dwJobNumberOfPagesPerSide;
  DWORD dwDrvNumberOfPagesPerSide;
  DWORD dwNupBorderFlags;
  DWORD dwJobPageOrderFlags;
  DWORD dwDrvPageOrderFlags;
  DWORD dwJobNumberOfCopies;
  DWORD dwDrvNumberOfCopies;
  DWORD dwColorOptimization;
  short dmPrintQuality;
  short dmYResolution;
  DWORD dwDuplexFlags;
  DWORD dwNupDirection;
  DWORD dwBookletFlags;
  DWORD dwScalingPercentX;
  DWORD dwScalingPercentY;
} ATTRIBUTE_INFO_4, *PATTRIBUTE_INFO_4;

Member

dwJobNumberOfPagesPerSide

Anzahl der Dokumentseiten, die auf einer Seite einer physischen Seite platziert werden sollen, wie vom Benutzer angefordert. Zulässige Werte sind 1, 2, 4, 6, 9 oder 16.

dwDrvNumberOfPagesPerSide

Anzahl der Dokumentseiten, die der Drucker und der Treiber auf einer Seite einer physischen Seite platzieren können. Dieser Wert muss 1 oder der für dwJobNumberOfPagesPerSide angegebene Wert sein.

dwNupBorderFlags

Einer der folgenden Bitflagwerte:

dwJobPageOrderFlags

Einer der folgenden Bitflagwerte:

dwDrvPageOrderFlags

Bitflags, die angeben, welche Optionen für die Seitenreihenfolge vom Drucker und Treiber unterstützt werden. Verwendet die gleichen Flags wie dwJobPageOrderFlags.

dwJobNumberOfCopies

Anzahl der Kopien des Druckauftrags, wie vom Benutzer angefordert.

dwDrvNumberOfCopies

Die maximale Anzahl von Kopien, die der Drucker und der Treiber gleichzeitig verarbeiten können, wobei Auftragsattribute wie das Sortieren und Heften berücksichtigt werden.

dwColorOptimization

Einer der folgenden Bitflagwerte:

dmPrintQuality

Wert, der anstelle des dmPrintQuality-Members der DEVMODEW-Struktur des Druckauftrags verwendet werden soll, wenn das COLOR_OPTIMIZATION-Flag in dwColorOptimization festgelegt ist.

dmYResolution

Wert, der anstelle des dmYResolution-Members der DEVMODEW-Struktur des Druckauftrags verwendet werden soll, wenn das COLOR_OPTIMIZATION-Flag in dwColorOptimization festgelegt ist.

dwDuplexFlags

Einer der folgenden Bitflagwerte, die beim Duplexdruck verwendet werden:

Legen Sie auf 0 fest, wenn Ihr Treiber keine dieser Optionen erfordert.

dwNupDirection

Einer der folgenden Bitflagwerte, die beim N-Up-Druck verwendet werden:

Dieses Flag wird nur berücksichtigt, wenn dwJobNumberOfPagesPerSide und/oder dwDrvNumberOfPagesPerSide angeben, dass der N-Up-Druck aktiv ist. Weitere Informationen finden Sie in den obigen Beschreibungen für dwJobNumberOfPagesPerSide und dwDrvNumberOfPagesPerSide.

dwBookletFlags

Wenn dwJobPageOrderFlags auf BOOKLET_PRINT festgelegt ist, gilt einer der folgenden Werte:

Wenn dwJobPageOrderFlags nicht auf BOOKLET_PRINT festgelegt ist, wird dwBookletFlags auf 0 festgelegt.

Dieses Flag wird nur berücksichtigt, wenn der dwJobPageOrderFlags-Member auf BOOKLET_PRINT festgelegt ist.

dwScalingPercentX

Skalierungsprozentsatz in horizontaler Richtung (x) im Verhältnis zum normalen Papierformat. Muss im Bereich von 1 bis 1000 liegen. Legen Sie auf 100 fest, wenn die Skalierung nicht durchgeführt wird.

Um vorhersagbare Druckergebnisse sicherzustellen, müssen dwScalingPercentX und dwScalingPercentY den gleichen Wert aufweisen.

dwScalingPercentY

Skalierungsprozentsatz in vertikaler (y)-Richtung in Bezug auf das normale Papierformat. Muss im Bereich von 1 bis 1000 liegen. Legen Sie auf 100 fest, wenn die Skalierung nicht durchgeführt wird.

Um vorhersagbare Druckergebnisse sicherzustellen, müssen dwScalingPercentX und dwScalingPercentY den gleichen Wert aufweisen.

Hinweise

Wenn der dmPrintQuality-Member der DEVMODEW-Struktur eines Druckauftrags ein negativer Wert ist, z. B. DMRES_HIGH, und wenn die Monochromfarboptimierung aktiviert ist, kann der Wechsel zwischen Farbe und Monochrom dazu führen, dass unterschiedliche Auflösungen verwendet werden. Dies liegt daran, dass DMRES_HIGH möglicherweise verschiedenen DPI-Werten für das Farb- und Monochromrendering zugewiesen werden. (Bei Von Unidrv unterstützten Geräten erfolgt diese Zuweisung in der GPD-Datei des Druckers.) Um eine konsistente Auflösung im gesamten Druckauftrag sicherzustellen, kann der Treiber positive werte dmPrintQuality und dmYResolution angeben (die eine bestimmte DPI-Auflösung darstellen), um die entsprechenden DEVMODEW-Werte zu überschreiben.

Der EMF-Druckprozessor verwendet das für dwColorOptimization angegebene Flag, um zu bestimmen, ob GDI zur Monochromfarboptimierung aufgefordert werden soll. Wenn die Monochromfarboptimierung aktiviert ist, kann der Druckauftrag je nach Bedarf zwischen Monochrom- und Farbrendering umgestellt werden.

Wenn Sie ein Unidrv-Rendering-Plug-In zum Generieren von Farbwasserzeichen erstellen, beachten Sie, dass beim Festlegen des dwColorOptimization-Members auf COLOR_OPTIMIZATION farbliche Wasserzeichen schwarzweiß gedruckt werden, wenn sie auf Schwarzweißdokumenten gedruckt werden. Deaktivieren Sie die Farboptimierung, um sicherzustellen, dass Farbwasserzeichen ordnungsgemäß mit Farb- und Schwarzweißdokumenten gedruckt werden. Die Farboptimierung kann auch vom Unidrv *ChangeColorModeOnDoc?- Farbattribute (siehe Farbattribute) und von der GdiEndPageEMF-Funktion gesteuert werden.

Eine Liste der Standardwerte für ATTRIBUTE_INFO_4 Member finden Sie unter GetJobAttributesEx.

Diese Struktur ist in Windows Vista verfügbar.

Anforderungen

Weitere Informationen

ATTRIBUTE_INFO_2

ATTRIBUTE_INFO_3

DrvQueryJobAttributes

GdiEndPageEMF

GetJobAttributesEx