DEVNAMES-Struktur (commdlg.h)

  • Artikel

Enthält Zeichenfolgen, die die Namen des Treibers, Geräts und Ausgabeports für einen Drucker identifizieren. Diese Zeichenfolgen müssen ANSI-Zeichenfolgen sein, wenn die ANSI-Version von PrintDlg oder PrintDlgEx verwendet wird, und müssen Unicode-Zeichenfolgen sein, wenn die Unicode-Version von PrintDlg oder PrintDlgEx verwendet wird. Die Funktionen PrintDlgEx und PrintDlg verwenden diese Zeichenfolgen, um das systemdefinierte Druckeigenschaftenblatt oder das Dialogfeld "Drucken" zu initialisieren. Wenn der Benutzer das Eigenschaftenblatt oder Dialogfeld schließt, werden Informationen zum ausgewählten Drucker in dieser Struktur zurückgegeben.

Syntax

typedef struct tagDEVNAMES {
  WORD wDriverOffset;
  WORD wDeviceOffset;
  WORD wOutputOffset;
  WORD wDefault;
} DEVNAMES;

Member

wDriverOffset

Typ: WORD

Der Offset in Zeichen vom Anfang dieser Struktur auf eine NULL-Zeichenfolge, die den Dateinamen (ohne die Erweiterung) des Gerätetreibers enthält. Bei der Eingabe wird diese Zeichenfolge verwendet, um den Drucker zu bestimmen, der zunächst im Dialogfeld angezeigt werden soll.

wDeviceOffset

Typ: WORD

Der Offset in Zeichen vom Anfang dieser Struktur bis zur NULL-Zeichenfolge, die den Namen des Geräts enthält.

wOutputOffset

Typ: WORD

Der Offset in Zeichen vom Anfang dieser Struktur bis zur NULL-Zeichenfolge, die den Gerätenamen für das physische Ausgabemedium (Ausgabeport) enthält.

wDefault

Typ: WORD

Gibt an, ob die in der DEVNAMES-Struktur enthaltenen Zeichenfolgen den Standarddrucker identifizieren. Diese Zeichenfolge wird verwendet, um zu überprüfen, ob sich der Standarddrucker seit dem letzten Druckvorgang nicht geändert hat. Wenn eine der Zeichenfolgen nicht übereinstimmt, wird eine Warnmeldung angezeigt, die den Benutzer darüber informiert, dass das Dokument möglicherweise neu formatiert werden muss. Bei der Ausgabe wird der wDefault-Member nur geändert, wenn das Dialogfeld Druckeinrichtung angezeigt wurde und der Benutzer die Schaltfläche OK ausgewählt hat. Das Flag DN_DEFAULTPRN wird verwendet, wenn der Standarddrucker ausgewählt wurde. Wenn ein bestimmter Drucker ausgewählt ist, wird das Flag nicht verwendet. Alle anderen Flags in diesem Member sind für die interne Verwendung durch die Dialogfeldprozedur für das Eigenschaftenblatt Drucken oder das Dialogfeld Drucken reserviert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile commdlg.h (einschließlich Windows.h)

Weitere Informationen

Allgemeine Dialogfeldbibliothek

Konzept

PrintDlg

PrintDlgEx

Referenz