Win32_PrinterConfiguration 類別

發行項
06/03/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 類別中的屬性來判斷色彩的呈現方式。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64)

目前物件的簡短文字描述。

此屬性繼承自 CIM_Setting。

自動分頁

資料類型： 布林值
存取類型：唯讀

如果 為 TRUE，則列印的頁面應該定序。若要定序是在列印下一份複本之前列印整份檔，而不是列印出檔的每個頁面所需的次數。

除非印表機驅動程式指出支援定序，否則會忽略這個屬性。

Color

資料類型： uint32
存取類型：唯讀

檔的色彩。某些色彩印表機可以使用真正的黑色來列印，而不是使用青色、洋紅色和黃色 (CMY) 的組合。這通常會為檔建立更深且更清楚的文字。此選項只適用于支援真實黑色列印的色彩印表機。

1

單色 (真黑色)

2

色彩

份數

資料類型： uint32
存取類型：唯讀

要列印的複本數目。印表機驅動程式必須支援列印多頁複本。

範例：2

說明

資料類型：字串
存取類型：唯讀

目前物件的文字描述。

此屬性繼承自 CIM_Setting。

DeviceName

資料類型：字串
存取類型：唯讀

印表機的易記名稱。此名稱對印表機類型而言是唯一的，而且可能會因為其衍生來源字串的限制而遭到截斷。

範例：「PCL/HP LaserJet」

DisplayFlags

資料類型： uint32
存取類型：唯讀

指出顯示裝置為色彩或單色，以及掃描類型為非交錯或交錯。這個屬性已經過時。請改用顯示內容，例如Win32_DesktopMonitor類別的DisplayType屬性。

DisplayFrequency

資料類型： uint32
存取類型：唯讀

顯示垂直重新整理速率。監視器的重新整理速率是螢幕每秒重新繪製的次數， (頻率) 。這個屬性已經過時。請改用 Win32_VideoController、 Win32_DesktopMonitor或 CIM_VideoControllerResolution 類別中的屬性。

DitherType

資料類型： uint32
存取類型：唯讀

印表機的 Dither 類型。此屬性可以假設預先定義的值為 1 到 5，或從 6 到 256 的驅動程式定義值。線條美工圖案 dithering 是一種特殊的 Dithering 方法，可在黑色、白色和灰色縮放之間產生定義完善的框線。它不適用於包含濃度和色調連續訓練的影像，例如掃描的相片。

無 Dithering

粗略筆刷

細筆刷

線條藝術

灰階

DriverVersion

資料類型： uint32
存取類型：唯讀

Windows 印表機驅動程式的版本號碼。驅動程式製造商會建立和維護版本號碼。

雙工

資料類型： 布林值
存取類型：唯讀

如果 為 TRUE，則會在兩側完成列印。如果 為 FALSE，列印只會在媒體的一端完成。

FormName

資料類型：字串
存取類型：唯讀

不支援。

HorizontalResolution

資料類型： uint32
存取類型：唯讀
限定 符：每 英吋的點數 (單位)

列印工作 (類似于過時 XResolution 屬性) ，以每英吋點為單位的列印解析度 () 寬度。只有在這個類別的 PrintQuality 屬性為正數時，才會設定此值。

ICMIntent

資料類型： uint32
存取類型：唯讀

三種可能色彩比對方法之一的特定值， (預設會呼叫意圖) 。 ICM 應用程式會使用 ICM 函式來建立意圖。此屬性可以假設預先定義的值為 1 到 3，或從 4 到 256 的驅動程式定義值。非 ICM 應用程式可以使用此值來判斷印表機如何處理色彩列印工作。

飽和度

對比

精確色彩

ICMMethod

資料類型： uint32
存取類型：唯讀

如何處理 ICM。對於非 ICM 應用程式，這個屬性會判斷 ICM 是否已啟用或停用。針對 ICM 應用程式，系統會檢查此屬性，以判斷電腦系統處理 ICM 支援的哪個部分。

已停用

Windows

設備磁碟機

裝置

LogPixels

資料類型： uint32
存取類型：唯讀
限定詞： 已被取代

每個邏輯英吋的圖元數目。這個過時屬性只適用于使用圖元的裝置，這不包括印表機之類的裝置。沒有適用于印表機的取代值。

MediaType

資料類型： uint32
存取類型：唯讀

印表機列印的媒體類型。屬性可以設定為預先定義的值或大於或等於 256 的驅動程式定義值。

標準

透明度

光澤

名稱

資料類型：字串
存取類型：唯讀
限定詞： Key、 MaxLen (256)

與此組態相關聯的印表機名稱。這個值符合相關聯Win32_Printer實例的Name屬性。

方向

資料類型： uint32
存取類型：唯讀

紙張的列印方向。

直向

橫向

PaperLength

資料類型： uint32
存取類型：唯讀
限定 符：單位 (公釐)

紙張的長度。若要判斷以英吋為單位的紙張大小，請將此值除以 254。

範例：2794

PaperSize

資料類型：字串
存取類型：唯讀

紙張大小。在相關聯Win32_Printer類別的PaperSizesSupported屬性中找到可能的大小。

範例：「A4 或 Letter」。

PaperWidth

資料類型： uint32
存取類型：唯讀
限定 符：單位 (公釐)

紙張的寬度。若要判斷以英吋為單位的紙張大小，請將此值除以 254。

範例：2159

PelsHeight

資料類型： uint32
存取類型：唯讀
限定詞： 已被取代

不支援這個屬性。

PelsWidth

資料類型： uint32
存取類型：唯讀
限定詞： 已被取代

不支援這個屬性。

PrintQuality

資料類型： uint32
存取類型：唯讀

列印工作的四個品質等級之一。如果指定正值，品質會以每英吋點為單位來測量。

-1

草稿

-2

低

-3

中

-4

高

調整

資料類型： uint32
存取類型：唯讀
限定詞： ( 百分比) 單位

要調整列印輸出的因數。例如，小數位數 75 會將列印輸出縮減為 3/4 其原始高度和寬度。

SettingID

資料類型：字串
存取類型：唯讀
限定詞： 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。

概觀

您必須先具備這些資源的詳細知識，才能判斷如何最佳散發和使用列印資源。例如，相較于部門 B 中的五部印表機，部門 A 可能只有三部印表機。不過，如果部門 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 類別

語法

成員

屬性

備註

範例

規格需求

另請參閱

意見反應

意見反應

其他資源