Win32 _ PrinterConfiguration-Klasse
Die WMI-Klasse _ Win32 PrinterConfiguration stellt die Konfiguration für ein Druckergerät dar. Dazu gehören Funktionen wie Auflösung, Farbe, Schriftarten und Ausrichtung.
Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.
Syntax
class Win32_PrinterConfiguration : CIM_Setting
{
string Caption;
string Description;
string SettingID;
uint32 BitsPerPel;
boolean Collate;
uint32 Color;
uint32 Copies;
string DeviceName;
uint32 DisplayFlags;
uint32 DisplayFrequency;
uint32 DitherType;
uint32 DriverVersion;
boolean Duplex;
string FormName;
uint32 HorizontalResolution;
uint32 ICMIntent;
uint32 ICMMethod;
uint32 LogPixels;
uint32 MediaType;
string Name;
uint32 Orientation;
uint32 PaperLength;
string PaperSize;
uint32 PaperWidth;
uint32 PelsHeight;
uint32 PelsWidth;
uint32 PrintQuality;
uint32 Scale;
uint32 SpecificationVersion;
uint32 TTOption;
uint32 VerticalResolution;
uint32 XResolution;
uint32 YResolution;
};
Member
Die Win32 _ PrinterConfiguration-Klasse verfügt über die folgenden Membertypen:
Eigenschaften
Die Win32 _ PrinterConfiguration-Klasse verfügt über diese Eigenschaften.
-
BitsPerPel
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet
Anzahl der Bits, die verwendet werden, um die Farbe in dieser Konfiguration (die Bits pro Pixel) darstellen. Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Eigenschaften in den Klassen Win32 _ VideoController, Win32 _ DesktopMonitoroder CIM _ VideoControllerResolution, um zu bestimmen, wie Farbe dargestellt wird.
-
-
Caption
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64)
Kurze Textbeschreibung des aktuellen Objekts.
Diese Eigenschaft wird von der CIM-Einstellung _ geerbt.
-
-
Sortieren
-
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
True gibt an, dass die seiten, die gedruckt werden, sortiert werden sollen. Die Sortierung besteht im Drucken des gesamten Dokuments vor dem Drucken der nächsten Kopie, anstatt jede Seite des Dokuments so oft wie erforderlich ausdrucken zu müssen.
Diese Eigenschaft wird ignoriert, es sei denn, der Druckertreiber gibt unterstützung für die Sortierung an.
-
-
Farbe
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Farbe des Dokuments. Einige Farbdrucker können mit echtem Schwarz statt einer Kombination aus Cyan, Magenta und Gelb (CMY) drucken. Dies erzeugt in der Regel dunkleren und schärferen Text für Dokumente. Diese Option ist nur für Farbdrucker nützlich, die echten Schwarzdruck unterstützen.
-
-
1
-
Monofarbig (true black)
-
2
-
Color
Exemplare
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Anzahl der zu druckenden Kopien. Der Druckertreiber muss das Drucken von Mehrseitenkopien unterstützen.
Beispiel: 2
Beschreibung
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Textbeschreibung des aktuellen -Objekts.
Diese Eigenschaft wird von der CIM-Einstellung _ geerbt.
Devicename
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Angezeigte Name des Druckers. Dieser Name ist für den Druckertyp eindeutig und kann aufgrund der Einschränkungen der Zeichenfolge, von der er abgeleitet wird, abgeschnitten werden.
Beispiel: "PCL/HPLasJet"
DisplayFlags
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob das Anzeigegerät farblich oder monofarbig ist und ob der Typ der Überprüfung nicht geschachtelt oder verschachtelt ist. Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Anzeigeeigenschaften wie die DisplayType-Eigenschaft der Win32 _ DesktopMonitor-Klasse.
DisplayFrequency
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Zeigt die vertikale Aktualisierungsrate an. Die Aktualisierungsrate für einen Monitor ist die Häufigkeit, mit der der Bildschirm pro Sekunde neu gezeichnet wird (Häufigkeit). Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen Eigenschaften in der Klasse Win32 _ VideoController, Win32 _ DesktopMonitoroder CIM _ VideoControllerResolution.
DitherType
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Dithertyp des Druckers. Diese Eigenschaft kann vordefinierte Werte von 1 bis 5 oder treiberdefinierte Werte von 6 bis 256 annehmen. Line Art Dithering ist eine spezielle Ditheringmethode, die klar definierte Rahmen zwischen schwarzer, weißer und grauer Skalierung erzeugt. Es eignet sich nicht für Bilder, die kontinuierliche Intensität und Farbton enthalten, z. B. gescannte Fotos.
1
Kein Dithering
2
Grober Pinsel
3
Fine Brush
4
Linienart
5
Grayscale
DriverVersion
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Versionsnummer des Windows-basierten Druckertreibers. Die Versionsnummern werden vom Treiberhersteller erstellt und verwaltet.
Duplex
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
True gibt an, dass der Druck auf beiden Seiten erfolgt. False gibt an, dass das Drucken nur auf einer Seite des Mediums erfolgt.
FormName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Wird nicht unterstützt.
HorizontalResolution
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten (Punkte pro Zoll)
Druckauflösung in Punkt pro Zoll entlang der x-Achse (Breite) des Druckauftrags (ähnlich der veralteten XResolution-Eigenschaft). Dieser Wert wird nur festgelegt, wenn die PrintQuality-Eigenschaft dieser Klasse positiv ist.
ICMIntent
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Bestimmter Wert einer der drei möglichen Farbabgleichsmethoden (als Absichten bezeichnet), die standardmäßig verwendet werden sollen. ICM Anwendungen erstellen Absichten mithilfe der ICM Funktionen. Diese Eigenschaft kann vordefinierte Werte von 1 bis 3 oder treiberdefinierte Werte von 4 bis 256 annehmen. Nicht-ICM können diesen Wert verwenden, um zu bestimmen, wie der Drucker Farbdruckaufträge verarbeitet.
1
Sättigung
2
Vergleichen Sie
3
Genaue Farbe
ICMMethod
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Wie ICM behandelt wird. Bei anwendungen, die ICM, bestimmt diese Eigenschaft, ob ICM aktiviert oder deaktiviert ist. Bei ICM untersucht das System diese Eigenschaft, um zu bestimmen, welcher Teil des Computersystems die ICM verarbeitet.
1
Disabled
2
Windows
3
Gerätetreiber
4
Gerät
LogPixels
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet
Anzahl von Pixeln pro logischem Zoll. Diese veraltete Eigenschaft ist nur für Geräte gültig, die mit Pixeln arbeiten, wodurch Geräte wie Drucker ausgeschlossen werden. Es gibt keinen Ersatzwert, der für Drucker gilt.
MediaType
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Medientyp, auf dem der Drucker gedruckt wird. Die -Eigenschaft kann auf einen vordefinierten Wert oder einen vom Treiber definierten Wert größer oder gleich 256 festgelegt werden.
1
Standard
2
Transparenz
3
Glänzend
Name
Name des Druckers, dem diese Konfiguration zugeordnet ist. Dieser Wert entspricht der Name-Eigenschaft der zugeordneten Win32-Druckerinstanz. _
Orientation
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Druckausrichtung des Papiers.
1
Hochformat
2
Querformat
PaperLength
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten (Zehntel eines Millimeters)
Länge des Papiers. Teilen Sie diesen Wert durch 254, um die Größe des Papiers in Zoll zu bestimmen.
Beispiel: 2794
Papersize
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Größe des Papiers. Die möglichen Größen finden Sie in der PaperSizesSupported-Eigenschaft der zugeordneten Win32 _ Printer-Klasse.
Beispiel: "A4 oder Buchstabe".
PaperWidth
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten (Zehntel eines Millimeters)
Breite des Papiers. Teilen Sie diesen Wert durch 254, um die Größe des Papiers in Zoll zu bestimmen.
Beispiel: 2159
IgkeitenHeight
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet
Diese Eigenschaft wird nicht unterstützt.
Beswidth
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet
Diese Eigenschaft wird nicht unterstützt.
PrintQuality
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Eine von vier Qualitätsstufen des Druckauftrags. Wenn ein positiver Wert angegeben wird, wird die Qualität in Punkt pro Zoll gemessen.
-1
Entwurf
-2
Niedrig
-3
Medium
-4
Hoch
Skalieren
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten (Prozent)
Faktor, um den die gedruckte Ausgabe skaliert werden soll. Beispielsweise reduziert eine Skala von 75 die Druckausgabe auf 3/4 ihrer ursprünglichen Höhe und Breite.
SettingID
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (256)
Bezeichner, unter dem das aktuelle Objekt bekannt ist.
Diese Eigenschaft wird von der CIM-Einstellung _ geerbt.
SpecificationVersion
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Versionsnummer der Initialisierungsdaten für das Gerät, das dem Windows Drucker zugeordnet ist.
TTOption
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, wie TrueType-Schriftarten gedruckt werden sollen.
Bitmap (1)
Druckt TrueType-Schriftarten als Grafiken. Dies ist die Standardaktion für Punktmatrixdrucker.
Herunterladen (2)
Lädt TrueType-Schriftarten als Softfonts herunter. Dies ist die Standardaktion für Drucker, die die Druckersteuerungssprache (PCL) verwenden.
Ersatz (3)
Ersetzt Geräteschriftarten durch TrueType-Schriftarten. Dies ist die Standardaktion für PostScript Drucker.
VerticalResolution
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten (Punkte pro Zoll)
Druckauflösung entlang der y-Achse (Höhe) des Druckauftrags (ähnlich der veralteten YResolution-Eigenschaft). Dieser Wert wird nur festgelegt, wenn die PrintQuality-Eigenschaft dieser Klasse positiv ist.
XResolution
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet
Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen die HorizontalResolution-Eigenschaft.
YResolution
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Veraltet
Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen die VerticalResolution-Eigenschaft.
Hinweise
Die Win32 _ PrinterConfiguration-Klasse wird von der _ CIM-Einstellung abgeleitet.
Übersicht
Bevor Sie bestimmen können, wie Sie Ihre Druckressourcen am besten verteilen und verwenden können, müssen Sie über ausführliche Kenntnisse dieser Ressourcen verfügen. Beispielsweise kann Abteilung A im Vergleich zu fünf Druckern in Abteilung B nur drei Drucker haben. Wenn die Drucker in Abteilung A jedoch 20 Seiten pro Minute drucken können und die Drucker in Abteilung B nur 5 Seiten pro Minute drucken können, verfügen Benutzer in Abteilung A tatsächlich über mehr Druckkapazität. Ohne die detaillierten Funktionen dieser Drucker zu kennen, können Sie fälschlicherweise zu dem Schluss kommen, dass Abteilung A nicht über die Druckkapazität verfügt, und daher zusätzliche Drucker erwerben, die ungenutzt werden.
WMI enthält zwei Klassen, Win32 _ Printer und Win32 _ PrinterConfiguration, die verwendet werden können, um ausführliche Informationen zu allen druckern zurück, die auf einem Computer installiert sind.
Beispiele
Im folgenden Codebeispiel werden Druckerinformationen abgerufen.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colInstalledPrinters = objWMIService.ExecQuery _
("SELECT * FROM Win32_PrinterConfiguration")
For Each objPrinter in colInstalledPrinters
Wscript.Echo "Name: " & objPrinter.Name
Wscript.Echo "Collate: " & objPrinter.Collate
Wscript.Echo "Copies: " & objPrinter.Copies
Wscript.Echo "Driver Version: " & objPrinter.DriverVersion
Wscript.Echo "Duplex: " & objPrinter.Duplex
Wscript.Echo "Horizontal Resolution: " & _
objPrinter.HorizontalResolution
If objPrinter.Orientation = 1 Then
strOrientation = "Portrait"
Else
strOrientation = "Landscape"
End If
Wscript.Echo "Orientation : " & strOrientation
Wscript.Echo "Paper Length: " & objPrinter.PaperLength / 254
Wscript.Echo "Paper Width: " & objPrinter.PaperWidth / 254
Wscript.Echo "Print Quality: " & objPrinter.PrintQuality
Wscript.Echo "Scale: " & objPrinter.Scale
Wscript.Echo "Specification Version: " & _
objPrinter.SpecificationVersion
If objPrinter.TTOption = 1 Then
strTTOption = "Print TrueType fonts as graphics."
ElseIf objPrinter.TTOption = 2 Then
strTTOption = "Download TrueType fonts as soft fonts."
Else
strTTOption = "Substitute device fonts for TrueType fonts."
End If
Wscript.Echo "True Type Option: " & strTTOption
Wscript.Echo "Vertical Resolution: " & objPrinter.VerticalResolution
Next
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|