Структура 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) |