classe Win32_PrinterConfiguration

Articolo
06/03/2023

La classe WMIWin32_PrinterConfiguration rappresenta la configurazione per un dispositivo stampante. Sono incluse funzionalità quali risoluzione, colore, tipi di carattere e orientamento.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non nell'ordine MOF.

Sintassi

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;
};

Members

La classe Win32_PrinterConfiguration ha questi tipi di membri:

Proprietà

Proprietà

La classe Win32_PrinterConfiguration ha queste proprietà.

BitsPerPel

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: deprecato

Numero di bit usati per rappresentare il colore in questa configurazione (i bit per pixel). Questa proprietà è obsoleta. Usare invece le proprietà nelle classi Win32_VideoController, Win32_DesktopMonitor o CIM_VideoControllerResolution per determinare come viene rappresentato il colore.

Didascalia

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (64)

Breve descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

Fascicola

Tipo di dati: booleano
Tipo di accesso: sola lettura

Se TRUE, le pagine stampate devono essere confrontate. Per eseguire la compressione, è necessario stampare l'intero documento prima di stampare la copia successiva, anziché stampare ogni pagina del documento il numero di volte richiesto.

Questa proprietà viene ignorata a meno che il driver della stampante non indichi il supporto per le regole di confronto.

Color

Tipo di dati: uint32
Tipo di accesso: sola lettura

Colore del documento. Alcune stampanti a colori hanno la possibilità di stampare utilizzando il nero reale anziché una combinazione di ciano, magenta e giallo (CMY). In genere viene creato testo più scuro e più nitido per i documenti. Questa opzione è utile solo per le stampanti a colori che supportano la stampa in nero reale.

1

Monocromatico (vero nero)

2

Color

Copie

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di copie da stampare. Il driver della stampante deve supportare la stampa di copie a più pagine.

Esempio: 2

Descrizione

Tipo di dati: string
Tipo di accesso: sola lettura

Descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

DeviceName

Tipo di dati: string
Tipo di accesso: sola lettura

Nome descrittivo della stampante. Questo nome è univoco per il tipo di stampante e può essere troncato a causa delle limitazioni della stringa da cui deriva.

Esempio: "PCL/HP LaserJet"

DisplayFlags

Tipo di dati: uint32
Tipo di accesso: sola lettura

Indica se il dispositivo di visualizzazione è di colore o monocromatico e se il tipo di scansione non è interlacciato o interlacciato. Questa proprietà è obsoleta. Usare invece proprietà di visualizzazione, ad esempio la proprietà DisplayType della classe Win32_DesktopMonitor .

DisplayFrequency

Tipo di dati: uint32
Tipo di accesso: sola lettura

Visualizza la frequenza di aggiornamento verticale. La frequenza di aggiornamento per un monitor è il numero di volte in cui lo schermo viene ridisegnato al secondo (frequenza). Questa proprietà è obsoleta. Usare invece le proprietà nella classe Win32_VideoController, Win32_DesktopMonitor o CIM_VideoControllerResolution .

DitherType

Tipo di dati: uint32
Tipo di accesso: sola lettura

Tipo dither della stampante. Questa proprietà può presupporre valori predefiniti da 1 a 5 o valori definiti dal driver da 6 a 256. La dithering della linea è un metodo speciale di dithering che produce bordi ben definiti tra le proporzioni nere, bianche e grigie. Non è adatto per immagini che includono la graduazione continua in intensità e tonalità, come le fotografie analizzate.

Nessun dithering

Pennello grossolano

Pennello fine

Linea d'arte

Gradazioni di grigio

DriverVersion

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di versione del driver della stampante basato su Windows. I numeri di versione vengono creati e gestiti dal produttore del driver.

Duplex

Tipo di dati: booleano
Tipo di accesso: sola lettura

Se TRUE, la stampa viene eseguita su entrambi i lati. Se FALSE, la stampa viene eseguita solo su un lato del supporto.

Nomemaschera

Tipo di dati: string
Tipo di accesso: sola lettura

Non supportato.

HorizontalResolution

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (punti per pollice)

Risoluzione di stampa in punti per pollice lungo l'asse x (larghezza) del processo di stampa (simile alla proprietà XResolution obsoleta). Questo valore viene impostato solo quando la proprietà PrintQuality di questa classe è positiva.

ICMIntent

Tipo di dati: uint32
Tipo di accesso: sola lettura

Valore specifico di uno dei tre metodi possibili di corrispondenza dei colori (denominati finalità) che devono essere usati per impostazione predefinita. Le applicazioni ICM stabiliscono finalità usando le funzioni ICM. Questa proprietà può presupporre valori predefiniti da 1 a 3 o valori definiti dal driver da 4 a 256. Le applicazioni non ICM possono usare questo valore per determinare come la stampante gestisce i processi di stampa a colori.

Saturazione

Si confronti

Colore esatto

ICMMethod

Tipo di dati: uint32
Tipo di accesso: sola lettura

Come viene gestito ICM. Per un'applicazione non ICM, questa proprietà determina se ICM è abilitato o disabilitato. Per le applicazioni ICM, il sistema esamina questa proprietà per determinare quale parte del sistema computer gestisce il supporto ICM.

Disabled

Windows

Driver di dispositivo

Dispositivo

LogPixels

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: deprecato

Numero di pixel per pollice logico. Questa proprietà obsoleta è valida solo con i dispositivi che funzionano con pixel, che esclude i dispositivi come le stampanti. Non esiste alcun valore sostitutivo applicabile alle stampanti.

MediaType

Tipo di dati: uint32
Tipo di accesso: sola lettura

Tipo di supporto su cui stampa la stampante. La proprietà può essere impostata su un valore predefinito o un valore definito dal driver maggiore o uguale a 256.

Standard

Trasparenza

Lucido

Nome

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Key, MaxLen (256)

Nome della stampante a cui è associata questa configurazione. Questo valore corrisponde alla proprietà Name dell'istanza di Win32_Printer associata.

Orientamento

Tipo di dati: uint32
Tipo di accesso: sola lettura

Orientamento della stampa del foglio.

Verticale

Orizzontale

PaperLength

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (decimi di millimetri)

Lunghezza del foglio. Per determinare le dimensioni della carta in pollici, dividere questo valore per 254.

Esempio: 2794

Papersize

Tipo di dati: string
Tipo di accesso: sola lettura

Dimensioni della carta. Le dimensioni possibili si trovano nella proprietà PaperSizesSupported della classe Win32_Printer associata.

Esempio: "A4 o Lettera".

PaperWidth

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (decimi di millimetri)

Larghezza del foglio. Per determinare le dimensioni della carta in pollici, dividere questo valore per 254.

Esempio: 2159

PelsHeight

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: deprecato

Questa proprietà non è supportata.

PelsWidth

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: deprecato

Questa proprietà non è supportata.

PrintQuality

Tipo di dati: uint32
Tipo di accesso: sola lettura

Uno dei quattro livelli di qualità del processo di stampa. Se viene specificato un valore positivo, la qualità viene misurata in punti per pollice.

-1

Bozza

-2

Basso

-3

Medio

-4

Alto

Ridimensionamento

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (percentuale)

Fattore in base al quale l'output stampato deve essere ridimensionato. Ad esempio, una scala di 75 riduce l'output di stampa a 3/4 l'altezza e la larghezza originali.

SettingID

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MaxLen (256)

Identificatore in base al quale l'oggetto corrente è noto.

Questa proprietà viene ereditata da CIM_Setting.

SpecificationVersion

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di versione dei dati di inizializzazione per il dispositivo associato alla stampante basata su Windows.

TTOption

Tipo di dati: uint32
Tipo di accesso: sola lettura

Indica la modalità di stampa dei tipi di carattere TrueType.

Bitmap (1)

Stampa i tipi di carattere TrueType come grafica. Si tratta dell'azione predefinita per le stampanti dot-matrix.

Download (2)

Scarica i tipi di carattere TrueType come tipi di carattere soft. Si tratta dell'azione predefinita per le stampanti che usano il linguaggio di controllo stampante (PCL).

Sostituzione (3)

Sostituisce i tipi di carattere del dispositivo per i tipi di carattere TrueType. Si tratta dell'azione predefinita per le stampanti PostScript.

VerticalResolution

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (punti per pollice)

Risoluzione di stampa lungo l'asse y (altezza) del processo di stampa (simile alla proprietà YResolution obsoleta). Questo valore viene impostato solo quando la proprietà PrintQuality di questa classe è positiva.

XResolution

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: Deprecato

Questa proprietà è obsoleta. Utilizzare invece la proprietà HorizontalResolution .

YResolution

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: Deprecato

Questa proprietà è obsoleta. Utilizzare invece la proprietà VerticalResolution .

Commenti

La classe Win32_PrinterConfiguration deriva da CIM_Setting.

Panoramica

Prima di poter determinare come distribuire e usare al meglio le risorse di stampa, è necessario avere una conoscenza dettagliata di queste risorse. Ad esempio, il reparto A potrebbe avere solo tre stampanti rispetto a cinque stampanti nel reparto B. Tuttavia, se le stampanti nel reparto A possono stampare 20 pagine al minuto e le stampanti in Reparto B possono stampare solo 5 pagine al minuto, gli utenti in Reparto A hanno effettivamente una capacità di stampa maggiore. Senza conoscere le funzionalità dettagliate di queste stampanti, è possibile concludere erroneamente che Department A è breve sulla capacità di stampa e quindi acquistare stampanti aggiuntive che finiscono inutilizzate.

WMI include due classi, Win32_Printer e Win32_PrinterConfiguration, che possono essere usate per restituire informazioni dettagliate su tutte le stampanti installate in un computer.

Esempio

L'esempio di codice seguente recupera le informazioni sulla stampante.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Radice\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Vedi anche

CIM_Setting
Classi hardware del sistema computer

Condividi tramite

classe Win32_PrinterConfiguration

Sintassi

Members

Proprietà

Commenti

Esempio

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive