Classe Win32_PrinterConfiguration

Artigo
06/03/2023

A classe WMIWin32_PrinterConfiguration representa a configuração de um dispositivo de impressora. Isso inclui recursos como resolução, cor, fontes e orientação.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

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

Membros

A classe Win32_PrinterConfiguration tem estes tipos de membros:

Propriedades

Propriedades

A classe Win32_PrinterConfiguration tem essas propriedades.

BitsPerPel

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: preterido

Número de bits usados para representar a cor nessa configuração (os bits por pixel). Esta propriedade está obsoleta. Em vez disso, use propriedades nas classes Win32_VideoController, Win32_DesktopMonitor ou CIM_VideoControllerResolution para determinar como a cor é representada.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64)

Descrição textual curta do objeto atual.

Essa propriedade é herdada de CIM_Setting.

Agrupar

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Se TRUE, as páginas impressas deverão ser agrupadas. Agrupar é imprimir todo o documento antes de imprimir a próxima cópia, em vez de imprimir cada página do documento o número necessário de vezes.

Essa propriedade é ignorada, a menos que o driver da impressora indique suporte para ordenação.

Color

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Cor do documento. Algumas impressoras coloridas têm a capacidade de imprimir usando preto verdadeiro em vez de uma combinação de ciano, magenta e amarelo (CMY). Isso geralmente cria texto mais escuro e mais nítido para documentos. Essa opção só é útil para impressoras coloridas que dão suporte à impressão preta verdadeira.

1

Monocromático (preto verdadeiro)

2

Cor

Cópias

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Número de cópias a serem impressas. O driver da impressora deve dar suporte à impressão de cópias de várias páginas.

Exemplo: 2

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Descrição textual do objeto atual.

Essa propriedade é herdada de CIM_Setting.

DeviceName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Nome amigável da impressora. Esse nome é exclusivo para o tipo de impressora e pode ser truncado devido às limitações da cadeia de caracteres da qual ela é derivada.

Exemplo: "PCL/HP LaserJet"

DisplayFlags

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Indica se o dispositivo de exibição é de cor ou monocromático e se o tipo de verificação não está entrelaçado ou entrelaçado. Esta propriedade está obsoleta. Em vez disso, use propriedades de exibição, como a propriedade DisplayType da classe Win32_DesktopMonitor .

DisplayFrequency

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Exibe a taxa de atualização vertical. A taxa de atualização de um monitor é o número de vezes que a tela é redesenhada por segundo (frequência). Esta propriedade está obsoleta. Em vez disso, use propriedades na classe Win32_VideoController, Win32_DesktopMonitor ou CIM_VideoControllerResolution .

DitherType

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Tipo dither da impressora. Essa propriedade pode assumir valores predefinidos de 1 a 5 ou valores definidos pelo driver de 6 a 256. O dithering de arte de linha é um método especial de dithering que produz bordas bem definidas entre escalas em preto, branco e cinza. Não é adequado para imagens que incluem formaturas contínuas em intensidade e matiz, como fotografias digitalizadas.

Sem dithering

Pincel Grosseiro

Pincel Fino

Arte de Linha

Escala de cinza

DriverVersion

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Número de versão do driver de impressora baseado no Windows. Os números de versão são criados e mantidos pelo fabricante do driver.

Duplex

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Se TRUE, a impressão será feita em ambos os lados. Se FALSE, a impressão será feita apenas em um lado da mídia.

FormName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Sem suporte.

HorizontalResolution

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: unidades (pontos por polegada)

Resolução de impressão em pontos por polegada ao longo do eixo x (largura) do trabalho de impressão (semelhante à propriedade XResolution obsoleta). Esse valor só é definido quando a propriedade PrintQuality dessa classe é positiva.

ICMIntent

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Valor específico de um dos três métodos possíveis de correspondência de cores (chamados de intenções) que devem ser usados por padrão. Os aplicativos ICM estabelecem intenções usando as funções do ICM. Essa propriedade pode assumir valores predefinidos de 1 a 3 ou valores definidos pelo driver de 4 a 256. Aplicativos não ICM podem usar esse valor para determinar como a impressora lida com trabalhos de impressão de cores.

Saturação

Contraste

Cor Exata

ICMMethod

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Como o ICM é tratado. Para um aplicativo não ICM, essa propriedade determina se o ICM está habilitado ou desabilitado. Para aplicativos ICM, o sistema examina essa propriedade para determinar qual parte do sistema do computador lida com o suporte do ICM.

Desabilitado

Windows

Driver de Dispositivo

Dispositivo

LogPixels

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: preterido

Número de pixels por polegada lógica. Essa propriedade obsoleta só é válida com dispositivos que funcionam com pixels, o que exclui dispositivos como impressoras. Não há nenhum valor de substituição que se aplique a impressoras.

MediaType

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Tipo de mídia na qual a impressora imprime. A propriedade pode ser definida como um valor predefinido ou um valor definido pelo driver maior ou igual a 256.

Standard

Transparência

Brilhante

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Key, MaxLen (256)

Nome da impressora à qual essa configuração está associada. Esse valor corresponde à propriedade Name da instância de Win32_Printer associada.

Orientation

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Orientação de impressão do papel.

Retrato

Paisagem

PaperLength

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: unidades (décimos de milímetro)

Comprimento do papel. Para determinar o tamanho do papel em polegadas, divida esse valor por 254.

Exemplo: 2794

Papersize

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Tamanho do papel. Os tamanhos possíveis são encontrados na propriedade PaperSizesSupported da classe Win32_Printer associada.

Exemplo: "A4 ou Carta".

PaperWidth

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: unidades (décimos de milímetro)

Largura do papel. Para determinar o tamanho do papel em polegadas, divida esse valor por 254.

Exemplo: 2159

PelsHeight

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: preterido

Não há suporte a esta propriedade.

PelsWidth

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: preterido

Não há suporte a esta propriedade.

PrintQuality

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Um dos quatro níveis de qualidade do trabalho de impressão. Se um valor positivo for especificado, a qualidade será medida em pontos por polegada.

-1

Rascunho

-2

Baixo

-3

Médio

-4

Alto

Escala

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: Unidades (Porcentagem)

Fator pelo qual a saída impressa deve ser dimensionada. Por exemplo, uma escala de 75 reduz a saída de impressão para 3/4 sua altura e largura originais.

Settingid

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (256)

Identificador pelo qual o objeto atual é conhecido.

Essa propriedade é herdada de CIM_Setting.

SpecificationVersion

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Número de versão dos dados de inicialização para o dispositivo associado à impressora baseada no Windows.

TTOption

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Indica como as fontes TrueType devem ser impressas.

Bitmap (1)

Imprime fontes TrueType como gráficos. Essa é a ação padrão para impressoras de matriz de pontos.

Baixar (2)

Baixa fontes TrueType como fontes suaves. Essa é a ação padrão para impressoras que usam a PCL (Linguagem de Controle de Impressora).

Substituto (3)

Substitui fontes de dispositivo por fontes TrueType. Essa é a ação padrão para impressoras PostScript.

VerticalResolution

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: unidades (pontos por polegada)

Imprimir resolução ao longo do eixo y (altura) do trabalho de impressão (semelhante à propriedade YResolution obsoleta). Esse valor só é definido quando a propriedade PrintQuality dessa classe é positiva.

XResolution

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: preterido

Esta propriedade está obsoleta. Em vez disso, use a propriedade HorizontalResolution .

YResolution

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: preterido

Esta propriedade está obsoleta. Em vez disso, use a propriedade VerticalResolution .

Comentários

A classe Win32_PrinterConfiguration é derivada de CIM_Setting.

Visão geral

Antes de determinar como distribuir e usar melhor seus recursos de impressão, você deve ter um conhecimento detalhado desses recursos. Por exemplo, o Departamento A pode ter apenas três impressoras em comparação com cinco impressoras no Departamento B. No entanto, se as impressoras do Departamento A puderem imprimir 20 páginas por minuto e as impressoras no Departamento B puderem imprimir apenas 5 páginas por minuto, os usuários do Departamento A realmente terão mais capacidade de impressão. Sem conhecer os recursos detalhados dessas impressoras, você pode concluir erroneamente que o Departamento A tem pouca capacidade de impressão e, portanto, comprar impressoras adicionais que acabam não sendo utilizadas.

O WMI inclui duas classes, Win32_Printer e Win32_PrinterConfiguration, que podem ser usadas para retornar informações detalhadas sobre todas as impressoras instaladas em um computador.

Exemplos

O exemplo de código a seguir recupera informações da impressora.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Confira também

CIM_Setting
Classes de hardware do sistema de computador

Compartilhar via

Classe Win32_PrinterConfiguration

Sintaxe

Membros

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais