Win32_PrinterConfiguration クラス
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 の場合、印刷されるページを照合する必要があります。 照合するには、ドキュメントの各ページを必要な回数印刷するのではなく、次のコピーを印刷する前にドキュメント全体を印刷します。
プリンター ドライバーが照合順序のサポートを示していない限り、このプロパティは無視されます。
-
-
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 の値を想定できます。 線画ディザリングは、黒、白、灰色のスケーリングの間に明確に定義された境界線を生成する特別なディザリング方法です。 スキャンされた写真など、強度と色相の連続的な卒業を含む画像には適していません。
1
ディザリングなし
2
粗いブラシ
細いブラシ
4
線画
5
グレースケール
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 以外のアプリケーションでは、この値を使用して、プリンターがカラー印刷ジョブを処理する方法を決定できます。
1
[鮮やかさ]
2
この例を、
正確な色
ICMMethod
-
データ型: uint32
-
アクセスの種類: 読み取り専用
ICM の処理方法。 非 ICM アプリケーションの場合、このプロパティは ICM が有効か無効かを決定します。 ICM アプリケーションの場合、システムはこのプロパティを調べて、コンピューター システムのどの部分が ICM サポートを処理するかを判断します。
1
無効
2
Windows
デバイス ドライバー
4
Device
LogPixels
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: 非推奨
論理インチあたりのピクセル数。 この古いプロパティは、プリンターなどのデバイスを除外するピクセルで動作するデバイスでのみ有効です。 プリンターに適用される置換値はありません。
MediaType
-
データ型: uint32
-
アクセスの種類: 読み取り専用
プリンターが印刷されるメディアの種類。 プロパティは、定義済みの値または 256 以上のドライバー定義値に設定できます。
1
Standard
2
透明性
光沢
名前
この構成が関連付けられているプリンターの名前。 この値は、関連付けられているWin32_Printer インスタンスの Name プロパティ と 一致します。
方向
-
データ型: uint32
-
アクセスの種類: 読み取り専用
用紙の印刷方向。
1
縦
2
横
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 |
|
[DLL] |
|
こちらもご覧ください