Win32_PrinterConfiguration classe
La classe WMI Win32_PrinterConfiguration représente la configuration d’un périphérique d’imprimante. Cela inclut des fonctionnalités telles que la résolution, la couleur, les polices et l’orientation.
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
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;
};
Membres
La classe Win32_PrinterConfiguration comporte les types de membres suivants :
Propriétés
La classe Win32_PrinterConfiguration a ces propriétés.
-
BitsPerPel
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : déconseillé
Nombre de bits utilisés pour représenter la couleur dans cette configuration (bits par pixel). Cette propriété est obsolète. Utilisez plutôt les propriétés des classes Win32_VideoController, Win32_DesktopMonitor ou CIM_VideoControllerResolution pour déterminer la façon dont la couleur est représentée.
-
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64)
Brève description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
-
-
Copies assemblées
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est TRUE, les pages imprimées doivent être rassemblées. Pour rassembler, vous devez imprimer l’intégralité du document avant d’imprimer la copie suivante, au lieu d’imprimer chaque page du document le nombre de fois requis.
Cette propriété est ignorée, sauf si le pilote d’imprimante indique la prise en charge du classement.
-
-
Color
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Couleur du document. Certaines imprimantes couleur ont la possibilité d’imprimer à l’aide d’un vrai noir au lieu d’une combinaison de cyan, de magenta et de jaune (CMY). Cela crée généralement un texte plus sombre et plus précis pour les documents. Cette option n’est utile que pour les imprimantes couleur qui prennent en charge l’impression noire véritable.
-
-
1
-
Monochrome (vrai noir)
-
2
-
Color
Copies
-
Type de données : uint32
-
Type d'accès : Lecture seule
Nombre de copies à imprimer. Le pilote d’imprimante doit prendre en charge l’impression de copies multipage.
Exemple : 2
Description
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
DeviceName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom convivial de l’imprimante. Ce nom est propre au type d’imprimante et peut être tronqué en raison des limitations de la chaîne dont il est dérivé.
Exemple : « PCL/HP LaserJet »
DisplayFlags
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si le périphérique d’affichage est couleur ou monochrome et si le type d’analyse est non interlacé ou entrelacé. Cette propriété est obsolète. Utilisez plutôt des propriétés d’affichage telles que la propriété DisplayType de la classe Win32_DesktopMonitor .
DisplayFrequency
-
Type de données : uint32
-
Type d'accès : Lecture seule
Affiche la fréquence d’actualisation verticale. La fréquence d’actualisation d’un moniteur correspond au nombre de fois que l’écran est redessiné par seconde (fréquence). Cette propriété est obsolète. Utilisez plutôt des propriétés dans la classe Win32_VideoController, Win32_DesktopMonitor ou CIM_VideoControllerResolution .
DitherType
-
Type de données : uint32
-
Type d'accès : Lecture seule
Type de trame de l’imprimante. Cette propriété peut supposer des valeurs prédéfinies de 1 à 5, ou des valeurs définies par le pilote de 6 à 256. Le tramage d’art linéaire est une méthode de trame spéciale qui produit des bordures bien définies entre les échelles noires, blanches et grises. Il ne convient pas aux images qui incluent des graduations continues en intensité et en teinte, telles que les photographies numérisées.
Aucun dithering
2
Pinceau grosseur
3
Pinceau fin
4
Image en courbes
5
Grayscale (Nuances de gris)
DriverVersion
-
Type de données : uint32
-
Type d'accès : Lecture seule
Numéro de version du pilote d’imprimante Windows. Les numéros de version sont créés et gérés par le fabricant du pilote.
Duplex
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est TRUE, l’impression est effectuée des deux côtés. Si la valeur est FALSE, l’impression n’est effectuée que sur un seul côté du support.
FormName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Non pris en charge.
HorizontalResolution
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (points par pouce)
Résolution d’impression en points par pouce le long de l’axe X (largeur) du travail d’impression (similaire à la propriété XResolution obsolète). Cette valeur est définie uniquement lorsque la propriété PrintQuality de cette classe est positive.
ICMIntent
-
Type de données : uint32
-
Type d'accès : Lecture seule
Valeur spécifique de l’une des trois méthodes de correspondance de couleurs possibles (appelées intentions) qui doivent être utilisées par défaut. Les applications ICM établissent des intentions à l’aide des fonctions ICM. Cette propriété peut supposer des valeurs prédéfinies de 1 à 3 ou des valeurs définies par le pilote comprises entre 4 et 256. Les applications non ICM peuvent utiliser cette valeur pour déterminer la façon dont l’imprimante gère les travaux d’impression couleur.
1
Saturation
2
Comparez
3
Couleur exacte
ICMMethod
-
Type de données : uint32
-
Type d'accès : Lecture seule
Comment ICM est géré. Pour une application non ICM, cette propriété détermine si ICM est activé ou désactivé. Pour les applications ICM, le système examine cette propriété pour déterminer la partie du système informatique qui gère la prise en charge des ICM.
Désactivé
2
Windows
3
Pilote de périphérique
4
Appareil
LogPixels
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : déconseillé
Nombre de pixels par pouce logique. Cette propriété obsolète est valide uniquement avec les appareils qui fonctionnent avec des pixels, ce qui exclut les appareils tels que les imprimantes. Aucune valeur de remplacement ne s’applique aux imprimantes.
MediaType
-
Type de données : uint32
-
Type d'accès : Lecture seule
Type de support sur lequel l’imprimante s’imprime. La propriété peut être définie sur une valeur prédéfinie ou une valeur définie par le pilote supérieure ou égale à 256.
1
Standard
2
Transparence
3
Brillant
Nom
Nom de l’imprimante à laquelle cette configuration est associée. Cette valeur correspond à la propriété Name du instance Win32_Printer associé.
Orientation
-
Type de données : uint32
-
Type d'accès : Lecture seule
Orientation d’impression du papier.
1
Portrait
2
Paysage
PaperLength
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (dixièmes de millimètre)
Longueur du papier. Pour déterminer la taille du papier en pouces, divisez cette valeur par 254.
Exemple : 2794
Taille de papier
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Taille du papier. Les tailles possibles se trouvent dans la propriété PaperSizesSupported de la classe Win32_Printer associée.
Exemple : « A4 ou LETTRE ».
PaperWidth
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (dixièmes de millimètre)
Largeur du papier. Pour déterminer la taille du papier en pouces, divisez cette valeur par 254.
Exemple : 2159
PelsHeight
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : déconseillé
Cette propriété n'est pas prise en charge.
PelsWidth
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : déconseillé
Cette propriété n'est pas prise en charge.
PrintQuality
-
Type de données : uint32
-
Type d'accès : Lecture seule
L’un des quatre niveaux de qualité du travail d’impression. Si une valeur positive est spécifiée, la qualité est mesurée en points par pouce.
-1
Brouillon
-2
Faible
-3
Moyenne
-4
Élevé
Mise à l’échelle
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : Unités (pourcentage)
Facteur selon lequel la sortie imprimée doit être mise à l’échelle. Par exemple, une échelle de 75 réduit la sortie d’impression à 3/4 sa hauteur et sa largeur d’origine.
SettingID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (256)
Identificateur par lequel l’objet actuel est connu.
Cette propriété est héritée de CIM_Setting.
SpecificationVersion
-
Type de données : uint32
-
Type d'accès : Lecture seule
Numéro de version des données d’initialisation de l’appareil associé à l’imprimante Windows.
TTOption
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique la façon dont les polices TrueType doivent être imprimées.
Bitmap (1)
Imprime les polices TrueType sous forme de graphiques. Il s’agit de l’action par défaut pour les imprimantes à matrice de points.
Télécharger (2)
Télécharge les polices TrueType en tant que polices logicielles. Il s’agit de l’action par défaut pour les imprimantes qui utilisent le langage de contrôle d’imprimante (PCL).
Remplacer (3)
Remplace les polices d’appareil par les polices TrueType. Il s’agit de l’action par défaut pour les imprimantes PostScript.
VerticalResolution
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (points par pouce)
Résolution d’impression le long de l’axe y (hauteur) du travail d’impression (similaire à la propriété YResolution obsolète). Cette valeur est définie uniquement lorsque la propriété PrintQuality de cette classe est positive.
XResolution
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : déconseillé
Cette propriété est obsolète. Utilisez plutôt la propriété HorizontalResolution .
YResolution
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : déconseillé
Cette propriété est obsolète. Utilisez plutôt la propriété VerticalResolution .
Notes
La classe Win32_PrinterConfiguration est dérivée de CIM_Setting.
Vue d'ensemble
Avant de pouvoir déterminer la meilleure façon de distribuer et d’utiliser vos ressources d’impression, vous devez avoir une connaissance détaillée de ces ressources. Par exemple, le département A peut avoir seulement trois imprimantes par rapport à cinq imprimantes dans le département B. Toutefois, si les imprimantes du département A peuvent imprimer 20 pages par minute et que les imprimantes du département B ne peuvent imprimer que 5 pages par minute, les utilisateurs du département A ont en fait plus de capacité d’impression. Sans connaître les fonctionnalités détaillées de ces imprimantes, vous pouvez conclure à tort que le département A manque de capacité d’impression et donc acheter des imprimantes supplémentaires qui finissent par être inutilisées.
WMI comprend deux classes, Win32_Printer et Win32_PrinterConfiguration, qui peuvent être utilisées pour retourner des informations détaillées sur toutes les imprimantes installées sur un ordinateur.
Exemples
L’exemple de code suivant récupère les informations d’imprimante.
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
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista |
Serveur minimal pris en charge |
Windows Server 2008 |
Espace de noms |
Racine\CIMV2 |
MOF |
|
DLL |
|
Voir aussi