Структура DEVMODEA (wingdi.h)

Структура данных DEVMODE содержит сведения об инициализации и среде принтера или устройства отображения.

Синтаксис

typedef struct _devicemodeA {
  BYTE  dmDeviceName[CCHDEVICENAME];
  WORD  dmSpecVersion;
  WORD  dmDriverVersion;
  WORD  dmSize;
  WORD  dmDriverExtra;
  DWORD dmFields;
  union {
    struct {
      short dmOrientation;
      short dmPaperSize;
      short dmPaperLength;
      short dmPaperWidth;
      short dmScale;
      short dmCopies;
      short dmDefaultSource;
      short dmPrintQuality;
    } DUMMYSTRUCTNAME;
    POINTL dmPosition;
    struct {
      POINTL dmPosition;
      DWORD  dmDisplayOrientation;
      DWORD  dmDisplayFixedOutput;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
  short dmColor;
  short dmDuplex;
  short dmYResolution;
  short dmTTOption;
  short dmCollate;
  BYTE  dmFormName[CCHFORMNAME];
  WORD  dmLogPixels;
  DWORD dmBitsPerPel;
  DWORD dmPelsWidth;
  DWORD dmPelsHeight;
  union {
    DWORD dmDisplayFlags;
    DWORD dmNup;
  } DUMMYUNIONNAME2;
  DWORD dmDisplayFrequency;
  DWORD dmICMMethod;
  DWORD dmICMIntent;
  DWORD dmMediaType;
  DWORD dmDitherType;
  DWORD dmReserved1;
  DWORD dmReserved2;
  DWORD dmPanningWidth;
  DWORD dmPanningHeight;
} DEVMODEA, *PDEVMODEA, *NPDEVMODEA, *LPDEVMODEA;

Члены

dmDeviceName[CCHDEVICENAME]

Массив символов с нулем, указывающий "понятное" имя принтера или дисплея; например, "PCL/HP LaserJet" в случае PCL/HP LaserJet. Эта строка является уникальной среди драйверов устройств. Обратите внимание, что это имя может быть усечено для размещения в массиве dmDeviceName .

dmSpecVersion

Номер версии спецификации данных инициализации, на которой основана структура. Чтобы убедиться, что для любой операционной системы используется правильная версия, используйте DM_SPECVERSION.

dmDriverVersion

Номер версии драйвера, назначенный разработчиком драйвера.

dmSize

Указывает размер (в байтах) структуры DEVMODE , не включая данные, относящиеся к частному драйверу, которые могут следовать за открытыми членами структуры. Задайте этому члену значение sizeof (DEVMODE) , чтобы указать версию используемой структуры DEVMODE .

dmDriverExtra

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

dmFields

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

Следующие значения определены и перечислены здесь с соответствующими элементами структуры.

Значение Элемент структуры
DM_ORIENTATION dmOrientation
DM_PAPERSIZE dmPaperSize
DM_PAPERLENGTH dmPaperLength
DM_PAPERWIDTH dmPaperWidth
DM_SCALE dmScale
DM_COPIES dmCopies
DM_DEFAULTSOURCE dmDefaultSource
DM_PRINTQUALITY dmPrintQuality
DM_POSITION dmPosition
DM_DISPLAYORIENTATION dmDisplayOrientation
DM_DISPLAYFIXEDOUTPUT dmDisplayFixedOutput
DM_COLOR dmColor
DM_DUPLEX dmDuplex
DM_YRESOLUTION dmYResolution
DM_TTOPTION dmTTOption
DM_COLLATE dmCollate
DM_FORMNAME dmFormName
DM_LOGPIXELS dmLogPixels
DM_BITSPERPEL dmBitsPerPel
DM_PELSWIDTH dmPelsWidth
DM_PELSHEIGHT dmPelsHeight
DM_DISPLAYFLAGS dmDisplayFlags
DM_NUP dmNup
DM_DISPLAYFREQUENCY dmDisplayFrequency
DM_ICMMETHOD dmICMMethod
DM_ICMINTENT dmICMIntent
DM_MEDIATYPE dmMediaType
DM_DITHERTYPE dmDitherType
DM_PANNINGWIDTH dmPanningWidth
DM_PANNINGHEIGHT dmPanningHeight

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation

Только для принтеров выбирает ориентацию бумаги. Этот элемент может быть DMORIENT_PORTRAIT (1) или DMORIENT_LANDSCAPE (2).

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Только для принтеров выбирает размер бумаги для печати. Этот элемент может быть равен нулю, если длина и ширина бумаги задаются элементами dmPaperLength и dmPaperWidth . В противном случае члену dmPaperSize можно задать значение устройства, превышающее или равное DMPAPER_USER или одно из следующих предопределенных значений.

Значение Значение
DMPAPER_LETTER Буква, 8 1/2- х 11 дюймов
DMPAPER_LEGAL Юридический, 8 1/2- х 14 дюймов
DMPAPER_9X11 Лист размером 9 на 11 дюймов
DMPAPER_10X11 Лист размером 10 на 11 дюймов
DMPAPER_10X14 Лист размером 10 на 14 дюймов
DMPAPER_15X11 Лист размером 15 на 11 дюймов
DMPAPER_11X17 Лист размером 11 на 17 дюймов
DMPAPER_12X11 Лист размером 12 на 11 дюймов
DMPAPER_A2 Лист A2, 420 x 594 миллиметра
DMPAPER_A3 Лист A3, 297 х 420 миллиметров
DMPAPER_A3_EXTRA A3 Экстра 322 x 445 миллиметров
DMPAPER_A3_EXTRA_TRAVERSE A3 Extra Transverse 322 x 445-миллиметров
DMPAPER_A3_ROTATED Повернутый лист A3, 420 на 297 миллиметров
DMPAPER_A3_TRAVERSE A3 Поперечные 297 x 420 миллиметров
DMPAPER_A4 Лист A4, 210 х 297 миллиметров
DMPAPER_A4_EXTRA Лист A4, 9,27 x 12,69 дюйма
DMPAPER_A4_PLUS A4 Plus 210 x 330 миллиметров
DMPAPER_A4_ROTATED A4 повернутый лист, 297- х 210 миллиметров
DMPAPER_A4SMALL A4 маленький лист, 210- х 297 миллиметров
DMPAPER_A4_TRANSVERSE A4 Поперечные 210 x 297 миллиметров
DMPAPER_A5 Лист A5, 148 х 210 миллиметров
DMPAPER_A5_EXTRA A5 Extra 174 x 235-миллиметров
DMPAPER_A5_ROTATED Лист A5, 210 на 148 миллиметров
DMPAPER_A5_TRANSVERSE A5 Поперечные 148 x 210 миллиметров
DMPAPER_A6 Лист A6, 105 х 148 миллиметров
DMPAPER_A6_ROTATED Повернутый лист A6, 148 на 105 миллиметров
DMPAPER_A_PLUS SuperA/A4 227 x 356 миллиметров
DMPAPER_B4 Лист B4, 250 х 354 миллиметров
DMPAPER_B4_JIS_ROTATED B4 (JIS) повернутый лист, 364 на 257 миллиметров
DMPAPER_B5 Лист B5, 182-257-миллиметровая бумага
DMPAPER_B5_EXTRA B5 (ISO) Extra 201 x 276-миллиметров
DMPAPER_B5_JIS_ROTATED B5 (JIS) повернутый лист, 257 на 182 миллиметра
DMPAPER_B6_JIS Лист B6 (JIS), 128 х 182 миллиметров
DMPAPER_B6_JIS_ROTATED B6 (JIS) повернутый лист, 182 на 128 миллиметров
DMPAPER_B_PLUS SuperB/A3 305 x 487 миллиметров
DMPAPER_CSHEET Лист C, 17 х 22 дюйма
DMPAPER_DBL_JAPANESE_POSTCARD Двойная японская открытка, 200- х 148-миллиметров
DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED Двойная японская открытка повернутая, 148- х 200-миллиметров
DMPAPER_DSHEET Лист D, 22 х 34 дюйма
DMPAPER_ENV_9 #9 Конверт, 3 7/8- на 8 7/8 дюймов
DMPAPER_ENV_10 #10 Конверт, 4 1/8- х 9 1/2 дюйма
DMPAPER_ENV_11 #11 Конверт, 4 1/2- х 10 3/8 дюймов
DMPAPER_ENV_12 #12 Конверт, 4 3/4- х 11 дюймов
DMPAPER_ENV_14 #14 Конверт, 5- х 11 1/2 дюйма
DMPAPER_ENV_C5 Конверт C5, 162- х 229 миллиметров
DMPAPER_ENV_C3 Конверт C3, 324 х 458 миллиметров
DMPAPER_ENV_C4 Конверт C4, 229- х 324 миллиметров
DMPAPER_ENV_C6 Конверт C6, 114- х 162 миллиметров
DMPAPER_ENV_C65 Конверт C65, 114- х 229 миллиметров
DMPAPER_ENV_B4 Конверт B4, 250 х 353 миллиметров
DMPAPER_ENV_B5 Конверт B5, 176 на 250 миллиметров
DMPAPER_ENV_B6 Конверт B6, 176 на 125 миллиметров
DMPAPER_ENV_DL Конверт DL, 110- х 220 миллиметров
DMPAPER_ENV_INVITE Приглашение конверта 220 x 220 мм
DMPAPER_ENV_ITALY Конверт Италии, 110- х 230 миллиметров
DMPAPER_ENV_MONARCH Конверт Monarch, 3 7/8- х 7 1/2 дюйма
DMPAPER_ENV_PERSONAL 6 конвертов 3/4, 3 5/8- 6 1/2 дюйма
DMPAPER_ESHEET Лист E, 34 х 44 дюйма
DMPAPER_EXECUTIVE Исполнительный, 7 1/4- х 10 1/2 дюйма
DMPAPER_FANFOLD_US US Std Fanfold, 14 7/8- х 11-дюймов
DMPAPER_FANFOLD_STD_GERMAN Немецкий Std Fanfold, 8 1/2- 12 дюймов
DMPAPER_FANFOLD_LGL_GERMAN Немецкий юридический вентилятор, 8 - на 13 дюймов
DMPAPER_FOLIO Фолио, 8 1/2- х 13-дюймовая бумага
DMPAPER_ISO_B4 B4 (ISO) 250 х 353 миллиметров бумаги
DMPAPER_JAPANESE_POSTCARD Японская открытка, 100 на 148 миллиметров
DMPAPER_JAPANESE_POSTCARD_ROTATED Японская открытка повернутая, 148- х 100 миллиметров
DMPAPER_JENV_CHOU3 Японский конверт Chou #3
DMPAPER_JENV_CHOU3_ROTATED Японский конверт Chou #3, повернутый
DMPAPER_JENV_CHOU4 Японский конверт Chou #4
DMPAPER_JENV_CHOU4_ROTATED Японский конверт Chou #4, повернутый
DMPAPER_JENV_KAKU2 Японский конверт Kaku #2
DMPAPER_JENV_KAKU2_ROTATED Японский конверт Каку #2, повернутый
DMPAPER_JENV_KAKU3 Японский конверт Kaku #3
DMPAPER_JENV_KAKU3_ROTATED Японский конверт Kaku #3, повернутый
DMPAPER_JENV_YOU4 Японский конверт Вы #4
DMPAPER_JENV_YOU4_ROTATED Японский конверт вы #4 повернуты
DMPAPER_LAST DMPAPER_PENV_10_ROTATED
DMPAPER_LEDGER Реестр, 17 на 11 дюймов
DMPAPER_LEGAL_EXTRA Legal Extra 9 1/2 x 15 дюймов.
DMPAPER_LETTER_EXTRA Letter Extra 9 1/2 x 12 дюймов.
DMPAPER_LETTER_EXTRA_TRANSVERSE Letter Extra Transverse 9 1/2 x 12 дюймов.
DMPAPER_LETTER_ROTATED Повернутая буква 11 на 8 1/2 дюйма
DMPAPER_LETTERSMALL Буква маленькая, 8 1/2- х 11 дюймов
DMPAPER_LETTER_TRANSVERSE Поперечные буквы 8 1/2 x 11 дюймов
DMPAPER_NOTE Обратите внимание, 8 1/2- 11 дюймов
DMPAPER_P16K PRC 16K, 146- х 215 миллиметров
DMPAPER_P16K_ROTATED PRC 16K вращаемый, 215-х 146-миллиметров
DMPAPER_P32K PRC 32K, 97 х 151 миллиметров
DMPAPER_P32K_ROTATED PRC 32K вращаемый, 151 на 97 миллиметров
DMPAPER_P32KBIG PRC 32K (Big) 97 х 151 миллиметров
DMPAPER_P32KBIG_ROTATED PRC 32K (Большой) вращаемый, 151 на 97 миллиметров
DMPAPER_PENV_1 Конверт КНР No 1, 102- х 165 миллиметров
DMPAPER_PENV_1_ROTATED Конверт КНР No 1 с повернутой, 165 на 102 миллиметра
DMPAPER_PENV_2 Конверт PRC No 2, 102- х 176 миллиметров
DMPAPER_PENV_2_ROTATED Конверт КНР No 2 повернутый, 176 на 102 миллиметра
DMPAPER_PENV_3 Конверт PRC No 3, 125- х 176 миллиметров
DMPAPER_PENV_3_ROTATED Конверт PRC No 3 повернутый, 176- х 125 миллиметров
DMPAPER_PENV_4 Конверт PRC No 4, 110- х 208-миллиметров
DMPAPER_PENV_4_ROTATED Конверт КНР No 4 повернутый, 208 на 110 миллиметров
DMPAPER_PENV_5 Конверт КНР No 5, 110- х 220 миллиметров
DMPAPER_PENV_5_ROTATED Конверт PRC No 5 повернутый, 220 на 110 миллиметров
DMPAPER_PENV_6 Конверт PRC No 6, 120- х 230 миллиметров
DMPAPER_PENV_6_ROTATED Конверт PRC No 6 повернутый, 230 на 120 миллиметров
DMPAPER_PENV_7 Конверт PRC No 7, 160- х 230 миллиметров
DMPAPER_PENV_7_ROTATED Конверт КНР No 7 повернутый, 230 на 160 миллиметров
DMPAPER_PENV_8 Конверт КНР No 8, 120- х 309 миллиметров
DMPAPER_PENV_8_ROTATED Конверт КНР No 8 повернутый, 309 на 120 миллиметров
DMPAPER_PENV_9 Конверт PRC No 9, 229- х 324-миллиметров
DMPAPER_PENV_9_ROTATED Конверт КНР No 9 повернутый, 324-х 229 миллиметров
DMPAPER_PENV_10 Конверт PRC No 10, 324- х 458 миллиметров
DMPAPER_PENV_10_ROTATED Конверт PRC No 10 вращаемый, 458-х 324-миллиметров
DMPAPER_QUARTO Кварто, 215- х 275-миллиметровая бумага
DMPAPER_STATEMENT Оператор, 5 1/2- 8 1/2 дюйма
DMPAPER_TABLOID Tabloid, 11- х 17-дюймов
DMPAPER_TABLOID_EXTRA Tabloid, 11,69 x 18 дюймов

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

Только для принтеров переопределяет длину бумаги, указанной элементом dmPaperSize , либо для пользовательских размеров бумаги, либо для устройств, таких как принтеры с точками матрицы, которые могут печатать на странице произвольной длины. Эти значения, наряду со всеми другими значениями в этой структуре, определяющими физическую длину, находятся в десятых миллиметрах.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

Только для принтеров переопределяет ширину бумаги, указанной элементом dmPaperSize .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

Указывает коэффициент масштабирования выводных данных. Видимый размер страницы масштабируется с физического размера страницы в коэффициенте dmScale /100. Например, страница размера буквы со значением dmScale 50 будет содержать столько данных, сколько страница размером 17 х 22 дюйма, так как выходной текст и графика будут вдвое меньше исходной высоты и ширины.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

Выбирает количество печатных копий, если устройство поддерживает многостраничные копии.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource

Указывает источник бумаги. Чтобы получить список доступных источников бумаги для принтера, используйте функцию DeviceCapabilities с флагом DC_BINS.

Этот элемент может быть одним из следующих значений или значением для конкретного устройства, которое больше или равно DMBIN_USER.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality

Задает разрешение принтера. Существует четыре предопределенных значения, независимых от устройства:

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

DUMMYUNIONNAME.dmPosition

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition

Только для устройств отображения — структура POINTL , указывающая позиционные координаты устройства отображения, ссылающиеся на область рабочего стола. Основное устройство отображения всегда находится в координатах (0,0).

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

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

Значение Значение
DMDO_DEFAULT Ориентация дисплея — это естественная ориентация устройства отображения; он должен использоваться по умолчанию.
DMDO_90 Ориентация дисплея поворачивается на 90 градусов (измеряется по часовой стрелке) от DMDO_DEFAULT.
DMDO_180 Ориентация дисплея поворачивается на 180 градусов (измеряется по часовой стрелке) от DMDO_DEFAULT.
DMDO_270 Ориентация дисплея поворачивается на 270 градусов (измеряется по часовой стрелке) от DMDO_DEFAULT.
 

Чтобы определить, является ли ориентация отображения книжной или альбомной, проверка соотношение dmPelsWidth и dmPelsHeight.

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

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Только для устройств отображения с фиксированным разрешением, как дисплей представляет режим низкого разрешения на дисплее с более высоким разрешением. Например, если разрешение устройства дисплея фиксированное на уровне 1024 x 768 пикселей, но его режим установлен в 640 x 480 пикселей, устройство может отображать изображение размером 640 x 480 где-то в интерьере экрана 1024 x 768 пикселей или растянуть изображение размером 640 x 480, чтобы заполнить большее пространство экрана. Если DM_DISPLAYFIXEDOUTPUT не задано, этот элемент должен быть равен нулю. Если задано DM_DISPLAYFIXEDOUTPUT, этот элемент должен иметь одно из следующих значений.

Значение Значение
DMDFO_DEFAULT Значение по умолчанию для дисплея.
DMDFO_CENTER Изображение с низким разрешением выравлируется по центру в большом пространстве экрана.
DMDFO_STRETCH Изображение с низким разрешением растягивается для заполнения большего пространства экрана.
 

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

dmColor

Переключается между цветом и монохромным цветом на цветных принтерах. Допустимы следующие значения:

  • DMCOLOR_COLOR
  • DMCOLOR_MONOCHROME

dmDuplex

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

Значение Значение
DMDUP_SIMPLEX Обычная (недуплексная) печать.
DMDUP_HORIZONTAL Привязка с коротким краем, то есть длинный край страницы является горизонтальным.
DMDUP_VERTICAL Привязка с длинным краем, то есть длинный край страницы является вертикальным.

dmYResolution

Указывает разрешение принтера по Y в точках на дюйм. Если принтер инициализирует этот элемент, член dmPrintQuality задает разрешение принтера в точках на дюйм.

dmTTOption

Указывает способ печати шрифтов TrueType. Этот элемент может быть одним из следующих значений.

Значение Значение
DMTT_BITMAP Выводит шрифты TrueType в виде графики. Это действие по умолчанию для принтеров точечной матрицы.
DMTT_DOWNLOAD Загружает шрифты TrueType в виде мягких шрифтов. Это действие по умолчанию для Hewlett-Packard принтеров, использующих язык управления принтерами (PCL).
DMTT_DOWNLOAD_OUTLINE Загружает шрифты TrueType в виде мягких шрифтов структуры.
DMTT_SUBDEV Заменяет шрифты устройства шрифтами TrueType. Это действие по умолчанию для принтеров PostScript.

dmCollate

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

Значение Значение
DMCOLLATE_TRUE Сортировка при печати нескольких копий.
DMCOLLATE_FALSE Не выполнять сортировку при печати нескольких копий.

dmFormName[CCHFORMNAME]

Массив символов с нулем, указывающий имя используемой формы; Например, "Letter" или "Legal". Полный набор имен можно получить с помощью функции EnumForms .

dmLogPixels

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

dmBitsPerPel

Задает разрешение цветов (в битах на пиксель) устройства отображения (например, 4 бита для 16 цветов, 8 битов для 256 цветов или 16 бит для 65 536 цветов). Драйверы отображения используют этот элемент, например, в функции ChangeDisplaySettings . Драйверы принтеров не используют этот элемент.

dmPelsWidth

Задает ширину видимой поверхности устройства (в пикселях). Драйверы отображения используют этот элемент, например, в функции ChangeDisplaySettings . Драйверы принтеров не используют этот элемент.

dmPelsHeight

Задает высоту видимой поверхности устройства (в пикселях). Драйверы отображения используют этот элемент, например, в функции ChangeDisplaySettings . Драйверы принтеров не используют этот элемент.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

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

Значение Значение
DM_GRAYSCALE Указывает, что дисплей является нецветным устройством. Если этот флаг не задан, предполагается цвет. Этот флаг больше недействителен.
DM_INTERLACED Указывает, что режим отображения чередуется. Если флаг не задан, предполагается неинтерлейс.
 

Драйверы отображения используют этот элемент, например, в функции ChangeDisplaySettings . Драйверы принтеров не используют этот элемент.

DUMMYUNIONNAME2.dmNup

Указывает, где выполняется NUP. Это может быть один из следующих вариантов.

Значение Значение
DMNUP_SYSTEM Очередь печати печати выполняет NUP.
DMNUP_ONEUP Приложение выполняет NUP.

dmDisplayFrequency

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

При вызове функции EnumDisplaySettings член dmDisplayFrequency может возвращать значение 0 или 1. Эти значения представляют частоту обновления оборудования дисплея по умолчанию. Эта скорость по умолчанию обычно устанавливается переключателями на дисплее карта или системной плате компьютера или программой настройки, которая не использует функции отображения, такие как ChangeDisplaySettings.

dmICMMethod

Указывает способ обработки ICM. Для приложений, отличных от ICM, этот член определяет, включена или отключена функция ICM. Для приложений ICM система проверяет этот элемент, чтобы определить, как обрабатывать поддержку ICM. Этот член может быть одним из следующих предопределенных значений или значением драйвера, которое больше или равно значению DMICMMETHOD_USER.

Значение Значение
DMICMMETHOD_NONE Указывает, что ICM отключен.
DMICMMETHOD_SYSTEM Указывает, что ICM обрабатывается Windows.
DMICMMETHOD_DRIVER Указывает, что ICM обрабатывается драйвером устройства.
DMICMMETHOD_DEVICE Указывает, что ICM обрабатывается конечным устройством.
 

Драйвер принтера должен предоставить пользовательский интерфейс для настройки этого элемента. Большинство драйверов принтеров поддерживают только DMICMMETHOD_SYSTEM или DMICMMETHOD_NONE значение. Драйверы для принтеров PostScript поддерживают все значения.

dmICMIntent

Указывает, какой метод сопоставления цветов или намерение следует использовать по умолчанию. Этот член в основном предназначен для приложений, не относящихся к ICM. Приложения ICM могут устанавливать намерения с помощью функций ICM. Это может быть одно из следующих предопределенных значений или определенное драйвером значение, большее или равное значению DMICM_USER.

Значение Значение
DMICM_ABS_COLORIMETRIC Сопоставление цветов должно оптимизироваться в соответствии с запрошенным цветом без сопоставления белых точек. Это значение наиболее подходит для использования при проверке правописания.
DMICM_COLORIMETRIC Сопоставление цветов должно оптимизироваться в соответствии с запрошенным цветом. Это значение наиболее подходит для использования с бизнес-логотипами или другими изображениями, когда нужно точное соответствие цвета.
DMICM_CONTRAST Сопоставление цветов должно оптимизироваться для цветовой контрастности. Это значение является наиболее подходящим вариантом для отсканированных или фотографических изображений, когда нужно выполнить мизерирование.
DMICM_SATURATE Сопоставление цветов должно оптимизироваться для насыщенности цвета. Это значение является наиболее подходящим вариантом для бизнес-графов, когда не рекомендуется использовать мизерирование.

dmMediaType

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

Значение Значение
DMMEDIA_STANDARD Обычная бумага.
DMMEDIA_GLOSSY Глянцевая бумага.
DMMEDIA_TRANSPARENCY Прозрачная пленка.
 

Чтобы получить список доступных типов носителей для принтера, используйте функцию DeviceCapabilities с флагом DC_MEDIATYPES.

dmDitherType

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

Значение Значение
DMDITHER_NONE Никакого дитинга.
DMDITHER_COARSE Смещание грубой кистью.
DMDITHER_FINE Дизеринг с тонкой кистью.
DMDITHER_LINEART Литейное рисование— специальный метод смежения, который создает четко определенные границы между черным, белым и серым масштабированием. Он не подходит для изображений, которые включают непрерывные градации по интенсивности и оттенку, например сканированные фотографии.
DMDITHER_GRAYSCALE Устройство выполняет серое масштабирование.

dmReserved1

Не используется; значение должно быть равно нулю.

dmReserved2

Не используется; значение должно быть равно нулю.

dmPanningWidth

Этот элемент должен быть равен нулю.

dmPanningHeight

Этот элемент должен быть равен нулю.

Комментарии

Частные данные драйвера устройства соответствуют общедоступной части структуры DEVMODE . Размер общедоступных данных может отличаться для разных версий структуры. Член dmSize указывает количество байтов общедоступных данных, а член dmDriverExtra — количество байт частных данных.

Примечание

Заголовок wingdi.h определяет DEVMODE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть wingdi.h (включая Windows.h)

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

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

DocumentProperties

EnumDisplaySettings

OpenPrinter

Структуры API очереди печати печати

Вывод на печать