DEVMODE

DEVMODE结构

DEVMODE结构具有如下形式：

typedef struct _devicemode

{ /* dvmd */

TCHAR dmDeviceName[32];

WORD dmSpecVersion;

WORD dmDriverVersion;

WORD dmSize;

WORD dmDriverExtra;

DWORD dmFields;

short dmOrientation;

short dmPaperSize;

short dmPaperLength;

short dmPaperWidth;

short dmScale;

short dmCopies;

short dmDefaultSource;

short dmPrintQuality;

short dmColor;

short dmDuplex;

short dmYResolution;

short dmTTOption;

short dmCollate;

TCHAR dmFormName[32];

WORD dmUnusedPadding;

USHORT dmBitsPerPel;

DWORD dmPelsWidth;

DWORD dmPelsHeight;

DWORD dmDisplayFlags;

DWORD dmDisplayFrequency;

} DEVMODE;

DEVMODE数据结构中包含了有关设备初始化和打印机环境的信息。

成员： dmDeviceName 指定了驱动程序支持的设备名称；例如，对于PCL/HP LaserJet系列，会是CL/HP激光打印机。这个字符串在设备驱动程序之间是相互不同的。

dmSpecVersion 指定了初始化数据的版本数字，这个结构就基于这些数据。

dmDriverVersion 指定了打印机驱动程序开发商分配的打印机驱动程序版本号。

dmSize 指定了DEVMODE结构的大小，以字节为单位，不包括dmDriverData（与设备有关）成员。如果应用程序仅操作数据中与驱动程序无关的部分，它就可以使用这个成员以确定该结构的长度，而并不需要有不同版本的记录。

dmDriverExtra 包含了这个结构后面的私有驱动程序数据的数目，以字节为单位。如果设备驱动程序不使用该设备独有的信息，就把这个成员设为零。

dmFields 指定了DEVMODE结构的其余成员中哪些已被初始化。第0位（定义为DM）ORIENTATION）代表dmOrientation，第1位（定义为 DM_PAPERSIZE）代表dmPaperSize等等。打印机驱动出现仅支持那些适合打印技术的成员。

dmOrientation 选择纸的方向。这个成员可以为DMORIENT_PORTRAIT（1）或DMORIENT_ LANDSCAPE（2）。

dmPaperSize 选择将用于打印的纸张大小。如果纸张的长度和宽度都用dmPaperLength和dmPaperWidth成员来设置的话，这个成员可以被设为0。否 则，dwPaperSize成员可以被设为以下值之一： DMPAPER_LETTER letter， 8 1/2×1 英寸

MPAPER_LEGAL Legal， 8 1/2×14 英寸

DMPAPER_A4 A4 letter， 210×297 毫米

DMPAPER_CSHEET C letter， 17×22 英寸

DMPAPER_DSHEET D letter， 22×34 英寸

DMPAPER_ESHEET E letter， 34×44 英寸

DMPAPER_LETTERSMALL letter small， 8 1/2×11 英寸

DMPAPER_TABLOID Tabloid， 11×17 英寸

DMPAPER_LEDGER Ledger， 17×11 英寸

DMPAPER_STATEMENT Statement， 5 1/2×8 1/2 英寸

DMPAPER_EXECUTIVE Executive， 7 1/4×10 1/2 英寸

DMPAPER_A3 A3 Sheet， 297×420 毫米

DMPAPER_A4SMALL A4 Small Sheet， 210×297 毫米

DMPAPER_A5 A5 Sheet， 148×210 毫米

DMPAPER_B4 B4 Sheet， 250×354 毫米

DMPAPER_B5 B5 Sheet， 182×257 毫米

DMPAPER_FOLIO Folio, 8 1/2×13 英寸

DMPAPER_QUARTO Quarto, 215×275 毫米

DMPAPER_10X14 10×14 英寸

DMPAPER_11X17 11×17 英寸

DMPAPER_NOTE Note, 8 1/2×11 英寸

DMPAPER_ENV_9 #9 EnVelope， 3 7/8×8 7/8 英寸

DMPAPER_ENV_10 #10 EnVelope， 4 1/8×9 1/2 英寸

DMPAPER_ENV_11 #11 EnVelope， 4 1/2×10 3/8 英寸

DMPAPER_ENV_12 #12 EnVelope， 4 3/4×11 英寸

DMPAPER_ENV_14 #14 EnVelope， 5×11 1/2 英寸

DMPAPER_ENV_DL DL EnVelope， 110×220 毫米

DMPAPER_ENV_C5 C5 EnVelope， 162×229 毫米

DMPAPER_ENV_C3 C3 EnVelope， 324×458 毫米

DMPAPER_ENV_C4 C4 EnVelope， 229×324 毫米

DMPAPER_ENV_C6 C6 EnVelope， 114×162 毫米

DMPAPER_ENV_C65 C65 EnVelope， 114×229 毫米

DMPAPER_ENV_B4 B4 EnVelope， 250×353 毫米

DMPAPER_ENV_B5 B5 EnVelope， 176×250 毫米

DMPAPER_ENV_B6 B6 EnVelope， 176×125 毫米

DMPAPER_ENV_ITALY Italy EnVelope， 110×230 毫米

DMPAPER_ENV_MONARCH Monarch EnVelope， 3 7/8×7 1/2 英寸

DMPAPER_ENV_PERSONAL 6 3/4 EnVelope， 3 5/8×6 1/2 英寸

DMPAPER_FANFOLD_US US Std Fanfold, 14 7/8×11 英寸

DMPAPER_FANFOLD_STD_GERMAN German Std Fanfold, 8 1/2×12 英寸

DMPAPER_FANFOLD_LGL_GERMAN German Legal Fanfold, 8 1/2×13 英寸



dmPaperLength 重定义由dmPaperSize成员指定的纸张长度，可用于自定义纸张大小，也可以用于点阵打印机，这种打印机能打出任意长度的纸张。这些值与这个结构中其他指定物理长度的值都是以0.1毫米为单位的。

dmPaperWidth 重载由dmPaperSize成员指定的纸张宽度。

dmScale 指定了打印输出的缩放因子。实际的页面大小为物理纸张的大小乘以dmScale/100。例如，对于信纸大小的纸张，如果dmScale的值为50，它将可以容纳相当于17×22英寸页面的内容，因为输出的文本和图形的宽、高都将是原始大小的一半。

dmCopies 如果设备支持多页拷贝，则选择了要打印的拷贝数目。

dmDefaultSource 保留，必须为0。

dmPrintQuality 指定了打印机的分辨率。有四种预定义的与设备无关的值：

DMRES_HIGH

DMRES_MEDIUM

DMRES_LOW

DMRES_DRAFT

如果给定了一个正值，它就指定了每英寸打印的点数（DPI），因此是与设备有关的。

dmColor 对于彩色打印机，在彩色和单色之间切换。下面是可能的取值：

·DMCOLOR_COLOR

·DMCOLOR_MONOCHROME

dmDuplex 为支持双面打印的打印机选择双面打印方式。可能的取值如下：

·DMDUP_SIMPLEX

·DMDUP_HORIZONTAL

·DMDUP_VERTICAL

dmYResolution 指定了打印机在y方向的分辨率，以每英寸的点数为单位。如果打印机对该成员进行了初始化，dmPrintQuality成员指定了打印机在x方向的分辨率，以每英寸点数为单位。

dmTTOption 指明如何打印TrueType字体。这个成员可以取如下值之一： · DMTT_BITMAP 把TrueType字体作为图形打印。这是点阵打印机的缺省动作。

· DMTT_DOWNLOAD 将TrueType字体作为软字体下载。这是使用打印机控制语言（PCL）的惠普打印机的缺省动作。

· DMTT_SUBDEV 用TrueType字体替换设备字体。这是PostScript系列打印机的缺省动作。



dmCollate 指定在打印多份拷贝的时候是否使用校对。使用DMCOLLATE_FALSE后能够得到更快更有效的输出，因为不管要打印多少份拷贝，只向打印机传送一次 数据。打印机仅被通知再打印一页。这个成员可以是下列值之一： · DMCOLLATE_TRUE 当打印多份拷贝时进行校对。

· DMCOLLATE_FALSE 当打印多份拷贝时不进行校对。



dmFormName 指定了要使用的格式名字。例如，Letter或Legal。这些名字的完整集合可以通过Windows的EnumForms函数获得。

dmUnusedPadding 用于将结构对齐到DWORD边界。不能使用或引用这个成员。它的名字和用法是保留的，在以后的版本中可能会变化。

dmBitsPerPel 指定了显示设备的颜色分辨率，以像素的位数为单位。例如，16色使用4位，256色使用8位，而65536色使用16位。

dmPelsWidth 指定了可见设备表面的以像素为单位的宽度。dmPelsHeight指定了可见设备表面的以像素为单位的高度。

dmDisplayFlags 指定了设备的显示模式。下面是有效的标志： · DM_GRAYSCALE 指定显示使用了无颜色设备。如果没有设置这个标志，就假定彩色模式。

· DM_INTERLACED 指定了隔行显示模式。如果没有设置这个标志，就假定非隔行模式。



dmDisplayFrequency 指定了显示设备的特定模式所使用的以赫兹为单位的频率（每秒的周期数）。

注释：

在dmDisplayMode成员后面将是一些设备驱动程序的私有数据。以字节为单位的私有数据数目是由dmDriverExtra成员指定的。

请参阅：CDC::ResetDC, CPrintDialog::GetDevMode