класс Win32_PrinterConfiguration

Статья
06/12/2023

Класс WMIWin32_PrinterConfiguration представляет конфигурацию устройства принтера. Сюда входят такие возможности, как разрешение, цвет, шрифты и ориентация.

Следующий пример синтаксиса — упрощенный 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 имеет следующие типы членов:

Свойства

Элемент Property

Класс Win32_PrinterConfiguration имеет эти свойства.

BitsPerPel

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: не рекомендуется

Число битов, используемых для представления цвета в этой конфигурации (битов на пиксель). Это свойство устарело. Вместо этого используйте свойства в классах Win32_VideoController, Win32_DesktopMonitor или CIM_VideoControllerResolution , чтобы определить способ представления цвета.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64)

Краткое текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

Разобрать по копиям

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, печатаемые страницы должны быть сложены. Сортировка — это печать всего документа перед печатью следующей копии, а не печать каждой страницы документа необходимое количество раз.

Это свойство игнорируется, если драйвер принтера не указывает на поддержку параметров сортировки.

Цвет

Тип данных: uint32
Тип доступа: только для чтения

Цвет документа. Некоторые цветные принтеры имеют возможность печатать с использованием истинно черного цвета вместо сочетания голубого, пурпурного и желтого (CMY). Обычно это создает более темный и четкий текст для документов. Этот параметр полезен только для цветных принтеров, поддерживающих настоящую черную печать.

1

Монохромный (истинный черный)

2

Цвет

Копии

Тип данных: uint32
Тип доступа: только для чтения

Число печатаемых копий. Драйвер принтера должен поддерживать печать многостраничных копий.

Пример: 2

Описание

Тип данных: string
Тип доступа: только для чтения

Текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

DeviceName

Тип данных: string
Тип доступа: только для чтения

Понятное имя принтера. Это имя уникально для типа принтера и может быть усечено из-за ограничений строки, из которой оно является производным.

Пример: PCL/HP LaserJet

DisplayFlags

Тип данных: uint32
Тип доступа: только для чтения

Указывает, является ли устройство отображения цветным или монохромным и является ли тип сканирования неинтерлейсированным или чередующимся. Это свойство устарело. Вместо этого используйте свойства отображения, такие как свойство DisplayType класса Win32_DesktopMonitor .

DisplayFrequency

Тип данных: uint32
Тип доступа: только для чтения

Отображает вертикальную частоту обновления. Частота обновления для монитора — это количество перерисовок экрана в секунду (частота). Это свойство устарело. Вместо этого используйте свойства в классе Win32_VideoController, Win32_DesktopMonitor или CIM_VideoControllerResolution .

DitherType

Тип данных: uint32
Тип доступа: только для чтения

Тип dither принтера. Это свойство может принимать предопределенные значения от 1 до 5 или определяемые драйвером значения от 6 до 256. Литейный рисунок — это специальный метод стирания, который создает четко определенные границы между черным, белым и серым масштабированием. Он не подходит для изображений, которые включают непрерывные градации по интенсивности и оттенку, например сканированные фотографии.

Без дитинга

Грубая кисть

Тонкая кисть

График

Оттенки серого

DriverVersion

Тип данных: uint32
Тип доступа: только для чтения

Номер версии драйвера принтера под управлением Windows. Номера версий создаются и поддерживаются производителем драйвера.

Дуплекс

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, печать выполняется с обеих сторон. Если значение РАВНО FALSE, печать выполняется только на одной стороне носителя.

FormName

Тип данных: string
Тип доступа: только для чтения

Не поддерживается.

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

Прозрачность

Глянцевая

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Key, MaxLen (256)

Имя принтера, с которым связана эта конфигурация. Это значение соответствует свойству Name связанного экземпляра Win32_Printer .

Ориентация

Тип данных: uint32
Тип доступа: только для чтения

Ориентация печати бумаги.

Книжная

Альбомная

PaperLength

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы (десятые миллиметра)

Длина бумаги. Чтобы определить размер бумаги в дюймах, разделите это значение на 254.

Пример: 2794

PaperSize

Тип данных: string
Тип доступа: только для чтения

Размер бумаги. Возможные размеры находятся в свойстве PaperSizesSupported связанного класса Win32_Printer .

Пример: "A4 или Letter".

PaperWidth

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы (десятые миллиметра)

Ширина бумаги. Чтобы определить размер бумаги в дюймах, разделите это значение на 254.

Пример: 2159

PelsHeight

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: не рекомендуется

Данное свойство не поддерживается.

PelsWidth

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: не рекомендуется

Данное свойство не поддерживается.

PrintQuality

Тип данных: uint32
Тип доступа: только для чтения

Один из четырех уровней качества задания печати. Если указано положительное значение, качество измеряется в точках на дюйм.

-1

Черновик

-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 .

Прежде чем определить, как лучше всего распространять и использовать ресурсы печати, необходимо иметь подробные знания об этих ресурсах. Например, в отделе А может быть только три принтера по сравнению с пятью принтерами в отделе B. Однако если принтеры в отделе А могут печатать 20 страниц в минуту, а принтеры в отделе Б могут печатать только 5 страниц в минуту, пользователи в отделе А фактически имеют большую емкость печати. Не зная подробных возможностей этих принтеров, вы можете ошибочно заключить, что отдел А не хватает на печать и, таким образом, приобретите дополнительные принтеры, которые в конечном итоге идут неиспользуемые.

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

Синтаксис

Члены

Элемент Property

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Обратная связь

Дополнительные ресурсы