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 クラスには、次の種類のメンバーがあります。

Properties

プロパティ

Win32_PrinterConfiguration クラスには、これらのプロパティがあります。

BitsPerPel

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

この構成の色を表すために使用されるビット数 (ピクセルあたりのビット数)。このプロパティは今後使用しません。代わりに、 Win32_VideoController、 Win32_DesktopMonitor、または CIM_VideoControllerResolution クラスのプロパティを使用して、色の表現方法を決定します。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)

現在のオブジェクトの短いテキスト説明。

このプロパティは、 CIM_Settingから継承されます。

[部単位で印刷]

データ型: ブール値
アクセスの種類: 読み取り専用

TRUE の場合、印刷されるページを照合する必要があります。照合するには、ドキュメントの各ページを必要な回数印刷するのではなく、次のコピーを印刷する前にドキュメント全体を印刷します。

プリンタードライバーが照合順序のサポートを示していない限り、このプロパティは無視されます。

Color

データ型: uint32
アクセスの種類: 読み取り専用

文書の色。一部のカラープリンターでは、シアン、マゼンタ、黄色 (CMY) の組み合わせではなく、真の黒を使用して印刷する機能があります。通常、これにより、ドキュメントのテキストが暗くなり、シャープになります。このオプションは、真の黒印刷をサポートするカラープリンターでのみ役立ちます。

1

モノクロ (真黒)

2

Color

[印刷部数]

データ型: uint32
アクセスの種類: 読み取り専用

印刷する部数。プリンタードライバーは、複数ページのコピーの印刷をサポートする必要があります。

例: 2

説明

データ型: string
アクセスの種類: 読み取り専用

現在のオブジェクトのテキスト説明。

このプロパティは、 CIM_Settingから継承されます。

DeviceName

データ型: string
アクセスの種類: 読み取り専用

プリンターのフレンドリ名。この名前はプリンターの種類に固有であり、派生元の文字列の制限により切り捨てられる場合があります。

例: "PCL/HP LaserJet"

DisplayFlags

データ型: uint32
アクセスの種類: 読み取り専用

ディスプレイデバイスがカラーかモノクロか、スキャンの種類が非インターレースかインターレースかを示します。このプロパティは今後使用しません。代わりに、Win32_DesktopMonitor クラスの DisplayType プロパティなどの表示プロパティを使用します。

DisplayFrequency

データ型: uint32
アクセスの種類: 読み取り専用

垂直方向の更新レートを表示します。モニターのリフレッシュレートは、画面が 1 秒あたりに再描画される回数 (頻度) です。このプロパティは今後使用しません。代わりに、 Win32_VideoController、Win32_DesktopMonitor、または CIM_VideoControllerResolution クラス のプロパティを 使用します。

DitherType

データ型: uint32
アクセスの種類: 読み取り専用

プリンターのディザタイプ。このプロパティでは、定義済みの値として 1 から 5、またはドライバーで定義された 6 ~ 256 の値を想定できます。線画ディザリングは、黒、白、灰色のスケーリングの間に明確に定義された境界線を生成する特別なディザリング方法です。スキャンされた写真など、強度と色相の連続的な卒業を含む画像には適していません。

ディザリングなし

粗いブラシ

細いブラシ

線画

グレースケール

DriverVersion

データ型: uint32
アクセスの種類: 読み取り専用

Windows ベースのプリンタードライバーのバージョン番号。バージョン番号は、ドライバーの製造元によって作成および管理されます。

二重

データ型: ブール値
アクセスの種類: 読み取り専用

TRUE の場合、両面で印刷が行われます。 FALSE の場合、印刷はメディアの片側でのみ行われます。

FormName

データ型: string
アクセスの種類: 読み取り専用

サポートされていません。

HorizontalResolution

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 単位 (1 インチあたりのドット数)

印刷ジョブの x 軸 (幅) に沿った 1 インチあたりのドット数の印刷解像度 (古い XResolution プロパティと同様)。この値は、このクラスの PrintQuality プロパティが正の場合にのみ設定されます。

ICMIntent

データ型: uint32
アクセスの種類: 読み取り専用

既定で使用する必要がある 3 つのカラーマッチングメソッド (意図と呼ばれます) の 1 つの特定の値。 ICM アプリケーションは、ICM 関数を使用して意図を確立します。このプロパティでは、定義済みの値として 1 から 3、またはドライバーで定義された 4 ~ 256 の値を想定できます。 ICM 以外のアプリケーションでは、この値を使用して、プリンターがカラー印刷ジョブを処理する方法を決定できます。

[鮮やかさ]

この例を、

正確な色

ICMMethod

データ型: uint32
アクセスの種類: 読み取り専用

ICM の処理方法。非 ICM アプリケーションの場合、このプロパティは ICM が有効か無効かを決定します。 ICM アプリケーションの場合、システムはこのプロパティを調べて、コンピューターシステムのどの部分が ICM サポートを処理するかを判断します。

無効

Windows

デバイスドライバー

Device

LogPixels

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

論理インチあたりのピクセル数。この古いプロパティは、プリンターなどのデバイスを除外するピクセルで動作するデバイスでのみ有効です。プリンターに適用される置換値はありません。

MediaType

データ型: uint32
アクセスの種類: 読み取り専用

プリンターが印刷されるメディアの種類。プロパティは、定義済みの値または 256 以上のドライバー定義値に設定できます。

Standard

透明性

光沢

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen (256)

この構成が関連付けられているプリンターの名前。この値は、関連付けられているWin32_Printer インスタンスの Name プロパティと一致します。

方向

データ型: uint32
アクセスの種類: 読み取り専用

用紙の印刷方向。

縦

横

PaperLength

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 単位 (ミリメートルの 10 分の 1)

用紙の長さ。用紙のサイズをインチ単位で決定するには、この値を 254 で割ります。

例: 2794

Papersize

データ型: string
アクセスの種類: 読み取り専用

用紙のサイズ。使用可能なサイズは、関連付けられている Win32_Printer クラスの PaperSizesSupported プロパティにあります。

例: "A4 or Letter"。

PaperWidth

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 単位 (ミリメートルの 10 分の 1)

用紙の幅。用紙のサイズをインチ単位で決定するには、この値を 254 で割ります。

例: 2159

PelsHeight

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

このプロパティはサポートされていません。

PelsWidth

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

このプロパティはサポートされていません。

PrintQuality

データ型: uint32
アクセスの種類: 読み取り専用

印刷ジョブの 4 つの品質レベルのいずれか。正の値を指定すると、品質は 1 インチあたりのドット単位で測定されます。

-1

ドラフト

-2

低

-3

Medium

-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
アクセスの種類: 読み取り専用
修飾子: 単位 (1 インチあたりのドット数)

印刷ジョブの y 軸 (高さ) に沿った印刷解像度 (古い YResolution プロパティに似ています)。この値は、このクラスの PrintQuality プロパティが正の場合にのみ設定されます。

XResolution

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

このプロパティは今後使用しません。代わりに HorizontalResolution プロパティを使用します。

YResolution

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

このプロパティは今後使用しません。代わりに VerticalResolution プロパティを使用します。

注釈

Win32_PrinterConfiguration クラスは、CIM_Settingから派生します。

概要

印刷リソースを最適に配布して使用する方法を決定する前に、それらのリソースに関する詳細な知識が必要です。たとえば、部門 A には、部門 B の 5 台のプリンターと比較して 3 つのプリンターしかない場合があります。ただし、部門 A のプリンターが 1 分あたり 20 ページ印刷でき、部門 B のプリンターが 1 分あたり 5 ページしか印刷できない場合、部門 A のユーザーは実際により多くの印刷容量を持ちます。これらのプリンターの詳細な機能を知らなくても、部門 A は印刷容量が不足していると誤って判断し、最終的に未使用になる追加のプリンターを購入する可能性があります。

WMI には、 コンピューターに インストールされているすべてのプリンターに関する詳細情報を返すために使用できる、 Win32_PrinterとWin32_PrinterConfigurationの 2 つのクラスが含まれています。

例

次のコードサンプルでは、プリンター情報を取得します。

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 クラス

構文

メンバー

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース