Win32_PrinterConfiguration classe

Article
06/12/2023

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

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

Pinceau grosseur

Pinceau fin

Image en courbes

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.

Saturation

Comparez

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é

Windows

Pilote de périphérique

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.

Standard

Transparence

Brillant

Nom

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Key, MaxLen (256)

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.

Portrait

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	Win32_Printer.mof
DLL	CIMWin32.dll

Voir aussi

CIM_Setting
Classes matérielles du système informatique

Win32_PrinterConfiguration classe

Syntaxe

Membres

Propriétés

Notes

Exemples

Spécifications

Voir aussi

Commentaires

Commentaires

Ressources supplémentaires