Win32_PrinterConfiguration 类

项目
06/12/2023

Win32_PrinterConfigurationWMI 类表示打印机设备的配置。这包括分辨率、颜色、字体和方向等功能。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

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

成员

Win32_PrinterConfiguration 类具有以下类型的成员：

属性

属性

Win32_PrinterConfiguration 类具有这些属性。

BitsPerPel

数据类型： uint32
访问类型：只读
限定符： 已弃用

用于表示此配置中颜色的位数 (每像素) 位数。此属性已过时。请改用 Win32_VideoController、 Win32_DesktopMonitor或 CIM_VideoControllerResolution 类中的属性来确定颜色的表示方式。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64)

当前对象的简短文本说明。

此属性继承自 CIM_Setting。

逐份打印

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则应整理打印的页面。整理是在打印下一份副本之前打印出整个文档，而不是按所需的次数打印出文档的每一页。

除非打印机驱动程序指示支持排序规则，否则将忽略此属性。

彩色

数据类型： uint32
访问类型：只读

文档的颜色。某些彩色打印机能够使用真黑色而不是青色、洋红色和黄色 (CMY) 进行打印。这通常会为文档创建更深、更清晰的文本。此选项仅适用于支持真黑色打印的彩色打印机。

1

单色 (真黑色)

2

Color

副本

数据类型： uint32
访问类型：只读

要打印的副本数。打印机驱动程序必须支持打印多页副本。

示例：2

描述

数据类型： string
访问类型：只读

当前对象的文本说明。

此属性继承自 CIM_Setting。

DeviceName

数据类型： string
访问类型：只读

打印机的友好名称。此名称对于打印机类型是唯一的，并且由于派生该名称的字符串的限制，可能会被截断。

示例：“PCL/HP LaserJet”

DisplayFlags

数据类型： uint32
访问类型：只读

指示显示设备是彩色还是单色，以及扫描类型是非交错还是隔行扫描。此属性已过时。请改用显示属性，例如Win32_DesktopMonitor类的 DisplayType 属性。

DisplayFrequency

数据类型： uint32
访问类型：只读

显示垂直刷新率。监视器的刷新速率是每秒重绘屏幕的次数， (频率) 。此属性已过时。请改用 Win32_VideoController、 Win32_DesktopMonitor 或 CIM_VideoControllerResolution 类中的属性。

DitherType

数据类型： uint32
访问类型：只读

打印机的抖澹类型。此属性可以假定预定义值 1 到 5，或驱动程序定义的值从 6 到 256。线条抖色是一种特殊的抖色方法，可在黑色、白色和灰色缩放之间生成明确定义的边框。它不适用于在强度和色调上包括连续分级的图像，例如扫描的照片。

无抖抖

粗画笔

细画笔

线条图

灰度

DriverVersion

数据类型： uint32
访问类型：只读

基于 Windows 的打印机驱动程序的版本号。版本号由驱动程序制造商创建和维护。

双工

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则打印在两侧完成。如果 为 FALSE，则仅在介质的一侧进行打印。

FormName

数据类型： 字符串
访问类型：只读

不支持。

HorizontalResolution

数据类型： uint32
访问类型：只读
限定符：单位 (点/英寸)

打印作业的 x 轴 (宽度) 的打印分辨率 (类似于过时的 XResolution 属性) 。仅当此类的 PrintQuality 属性为正时，才会设置此值。

ICMIntent

数据类型： uint32
访问类型：只读

三种可能的颜色匹配方法之一的特定值 (默认应使用的意向) 。 ICM 应用程序使用 ICM 函数建立意向。此属性可以假定预定义值 1 到 3，或驱动程序定义的值从 4 到 256。非 ICM 应用程序可以使用此值来确定打印机如何处理彩色打印作业。

饱和度

与此示例

精确颜色

ICMMethod

数据类型： uint32
访问类型：只读

如何处理 ICM。对于非 ICM 应用程序，此属性确定是启用或禁用 ICM。对于 ICM 应用程序，系统会检查此属性以确定计算机系统的哪个部分处理 ICM 支持。

已禁用

Windows

设备驱动程序

设备

LogPixels

数据类型： uint32
访问类型：只读
限定符： 已弃用

每逻辑英寸的像素数。此过时属性仅对使用像素的设备有效，这不包括打印机等设备。没有适用于打印机的替换值。

MediaType

数据类型： uint32
访问类型：只读

打印机打印的介质类型。属性可以设置为预定义值或驱动程序定义的大于或等于 256 的值。

Standard

透明度

光泽

名称

数据类型： 字符串
访问类型：只读
限定符：键、 MaxLen (256)

与此配置关联的打印机的名称。此值与关联的 Win32_Printer 实例的 Name 属性匹配。

方向

数据类型： uint32
访问类型：只读

纸张的打印方向。

纵向

横向

PaperLength

数据类型： uint32
访问类型：只读
限定符：单位 (十分之一毫米)

纸张的长度。若要确定纸张的大小（以英寸为单位），请将此值除以 254。

示例：2794

PaperSize

数据类型： 字符串
访问类型：只读

纸张的大小。可以在关联的Win32_Printer类的 PaperSizesSupported 属性中找到可能的大小。

示例：“A4 或字母”。

PaperWidth

数据类型： uint32
访问类型：只读
限定符：单位 (十分之一毫米)

纸张的宽度。若要确定纸张的大小（以英寸为单位），请将此值除以 254。

示例：2159

PelsHeight

数据类型： uint32
访问类型：只读
限定符： 已弃用

不支持此属性。

PelsWidth

数据类型： uint32
访问类型：只读
限定符： 已弃用

不支持此属性。

PrintQuality

数据类型： uint32
访问类型：只读

打印作业的四个质量级别之一。如果指定了正值，则质量以每英寸点数度量。

-1

Draft

-2

低

-3

中型

-4

高

可伸缩

数据类型： uint32
访问类型：只读
限定符：单位 (百分比)

缩放打印输出所依据的因子。例如，比例为 75 会将打印输出减少到其原始高度和宽度的 3/4。

SettingID

数据类型： string
访问类型：只读
限定符： MaxLen (256)

已知当前对象的标识符。

此属性继承自 CIM_Setting。

SpecificationVersion

数据类型： uint32
访问类型：只读

与基于 Windows 的打印机关联的设备的初始化数据的版本号。

TTOption

数据类型： uint32
访问类型：只读

指示应如何打印 TrueType 字体。

位图 (1)

将 TrueType 字体打印为图形。这是点阵打印机的默认操作。

下载 (2)

将 TrueType 字体下载为软字体。这是使用打印机控制语言 (PCL) 的打印机的默认操作。

替换 (3)

将设备字体替换为 TrueType 字体。这是 PostScript 打印机的默认操作。

VerticalResolution

数据类型： uint32
访问类型：只读
限定符：单位 (每英寸) 点数

沿打印作业的 y 轴 (高度) 的打印分辨率 (类似于过时的 YResolution 属性) 。仅当此类的 PrintQuality 属性为正时，才设置此值。

XResolution

数据类型： uint32
访问类型：只读
限定符： 已弃用

此属性已过时。请改用 HorizontalResolution 属性。

YResolution

数据类型： uint32
访问类型：只读
限定符： 已弃用

此属性已过时。请改用 VerticalResolution 属性。

备注

Win32_PrinterConfiguration 类派生自 CIM_Setting。

概述

在确定如何以最佳方式分发和使用打印资源之前，必须详细了解这些资源。例如，部门 A 可能只有三台打印机，而部门 B 中只有五台打印机。但是，如果部门 A 中的打印机每分钟可以打印 20 页，而部门 B 中的打印机每分钟只能打印 5 页，则部门 A 中的用户实际上具有更多的打印能力。在不知道这些打印机的详细功能的情况下，你可能会错误地得出结论，即部门 A 的打印能力不足，因此购买了最终未使用的其他打印机。

WMI 包括两个类 ，Win32_Printer 和 Win32_PrinterConfiguration，可用于返回有关计算机上安装的所有打印机的详细信息。

示例

以下代码示例检索打印机信息。

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

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

另请参阅

CIM_Setting
计算机系统硬件类

通过

Win32_PrinterConfiguration 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

其他资源