结构、风格、回调函数和消息映射

这个部分描述了微软基础类库使用的结构，风格和回调函数，还描述了 MFC

的消息映射。

MFC 使用的结构

这个主题后面是对不同成员函数调用的结构的描述。有关每个结构的用法的进一步信息参看每个结构的 “ 请参阅 ” 列表中列出的类和成员函数。

ABC 结构

ABC 结构具有如下形式：

typedef struct _ABC { /* abc */ int abcA;

UINT abcB;

int abcC;

} ABC;

ABC 结构包含了 TrueType 字体中字符的宽度。

成员

abcA abcB abcC

指定了字符的 A 宽度。 A 宽度是指画出的字符图形离当前位置的距离。指定了字符的 B 宽度。 B 宽度是指画出的字符图形的宽度。

指定了字符的 C 宽度。 C 宽度是指加在当前位置上的距离，用于提供字符图形右边的空白。

注释

字符的总宽度是 A ， B 和 C 宽度的总和。 A 或 C 宽度都可以是负的，指明上悬或下垂。

请参阅 CDC::GetCharABCWidths

ABCFLOAT 结构

ABCFLOAT 结构具有如下形式：

typedef struct _ABCFLOAT { /* abcf */ FLOAT abcfA;

FLOAT abcfB;

FLOAT abcfC;

} ABCFLOAT;

ABCFLOAT 结构包含了字符的 A ， B 和 C 宽度。

成员

abcfA abcf B abcf C

指定了字符的 A 宽度。 A 宽度是指画出的字符图形离当前位置的距离。指定了字符的 B 宽度。 B 宽度是指画出的字符图形的宽度。

指定了字符的 C 宽度。 C 宽度是指加在当前位置上的距离，用于提供字符图形右边的空白。

A ， B 和 C 宽度是根据字体的基准线测量的。字符的增量（总宽度）是 A ， B

和 C 宽度的总和。 A 或 C 宽度都可以是负数，表明上悬或下垂。

请参阅 CDC::Get CharABCWidths

AFX_EXTENSION_MODULE 结构

AFX_EXTENSION_MODULE 结构具有如下形式：

struct AFX_EXTENSION_MODULE

{

BOOL bInitialized; HMODULE hModule; HMODULE hResource;

CRuntimeClass* pFirstSharedClass; COleObjectFactory* pFirstSharedFactory;

};

AFX_EXTENSION_MODULE 被用在 MFC 扩展 DLL 的初始化过程中，用于保存扩展 DLL 模块的状态。

bInitialized

如果 DLL 模块已经用 AfxInitExtensionModule 初始化了，则为 TRU E 。

hModule

指定了 DLL 模块的句柄。

hResource

指定了 DLL 的自定义资源模块的句柄。

pFirstSharedClass

指向有关 DLL 模块的第一个运行时类的信息（ CRuntimeClass 结构）的指针。用于提供运行时类列表的开始部分。

pFirstSharedFactory

指向 DLL 模块的第一个对象工厂（ COleObjectFactory 对象）的指针。用于提供类工厂列表的开始部分。

注释

MFC 扩展 DLL 需要在它们的 D llM ain 函数中做两件事情：

调用 AfxInitExtensionModule 并检查返回值。
如果 DLL 要引出 CRuntimeClass 对象或者拥有它自己的资源

，就创建一个

CDynLinkLibrary 对象。

AFX_EXTENSION_MODULE 结构被用于保存扩展 DLL 模块状态的一个备份，包括运行时对象的一个拷贝，它已经在进入 D llM ain 函数之前被扩展 DLL 作为常规静态对象构造过程的一部分初始化过了。例如：

static AFX_EXTENSION_MODULE extensionDLL; extern "C" int APIENTRY

D llM ain(HINSTANCE hInstance, DWORD dwReason, LPVOID)

{

// 初始化这个 DLL 的扩展模块

VERIFY(AfxInitExtensionModule(extensionDLL, hInstance)); AFX_EXTENSION_MODULE 结构中保存的模块信息可以被拷贝到CDynLinkLibrary 对象中。例如：

// CDynLinkLibrary 类

IMPLEMENT_DYNAMIC(CDynLinkLibrary, CCmdTarget)

// 构造函数

CDynLinkLibrary::CDynLinkLibrary(AFX_EXTENSION_MODULE& state, BOOL bSystem)

{

#ifndef _AFX_NO_OLE_SUPPORT m_factoryList.Construct(offsetof(COleObjectFactory, m_pNextFactory));

#endif

m_classList.Construct(offsetof(CRuntimeClass, m_pNextClass));

// 从 AFX_EXTENSION_MODULE 结构中拷贝信息

ASSERT(state.hModule != NULL); m_hModule = state.hModule; m_hResource = state.hResource;

m_classList.m_pHead = state.pFirstSharedClass;

#ifndef _AFX_NO_OLE_SUPPORT m_factoryList.m_pHead = state.pFirstSharedFactory;

#endif

m_bSystem = bSystem;

请参阅 AfxInitExtensionModule, AfxTermExtensionModule

BITMAP 结构

BITMAP 结构具有如下形式：

typedef struct tagBITMAP { /* bm */ int bmType;

int bmWidth;

int bmHeight;

int bmWidthBytes; BYTE bmPlanes;

BYTE bmBitsPixel; LPVOID bmBits;

} BITMAP;

BITMAP 结构定义了逻辑位图的高，宽，颜色格式和位值。

成员

bmType

指定了位图的类型。对于逻辑位图，这个成员必须为 0 。

bmWidth

指定了位图的宽度，以像素为单位。宽度必须大于 0 。

bmHeight

指定了位图的高度，以扫描行为单位。高度必须大于 0 。

bmWidthBytes

指定了每个扫描行中字节的数目。这个值必须是个偶数，因为图形设备接口（ GD I ）假定位图中的位值构成一个整数（ 2 字节）数组。换句话说， bmWidthBytes*8 必须是 16 的倍数，大于或等于 bmWidth 与 bmBitsPixel 相乘所得的值。

bmPlanes

指定了位图中颜色平面的数目。

bmBits

指定了每个位平面中用于定义一个像素所需的颜色位数。

指向位图中位值的位置。 bmBits 成员必须是一个指向单字节数组的长指针。

注释

现在使用的位图格式有单色的和彩色的。单色的位图使用每个位平面一位的格式。每个扫描线是 16 的倍数。

对于一个高度为 n 的单色位图，扫描线是按照如下方式组织的：

Scan 0

Scan 1

Scan n-2 Scan n-1

单色设备上的像素不是黑就是白。如果位图中对应的位是 1 ，则像素就被打开

（白）。如果对应的位是 0 ，则像素被关闭（黑）。

员函数的 RASTERCAPS 索引中设置的。

每个设备都有它自己的颜色格式。为了在不同的设备间传递位图，使用 W indows

的 GetDIBits 和 SetDIBits 函数。

请参阅 CBitmap::CreateBitmapIndirect

BITMAPINFO 结构

BITMAPINFO 结构具有如下形式：

typedef struct tagBITMAPINFO { BITMAPINFOHEADER bmiHeader; RGBQUAD bmiColors[1];

} BITMAPINFO;

BITMAPINFO 结构定义了 W indows 设备无关位图（ DIB ）的度量和颜色信息。

成员

bmiHeader

指定了一个 BITMAPINFOHEADER 结构，包含了有关设备相关位图的度量和颜色格式的信息。

指定了一个 RGBQUAD 或 DWORD 数据类型的数组，定义了位图中的颜色。

注释

设备无关位图由两个部分组成：一个 BITMAPINFO 结构，描述了位图的度量和颜色信息；一个字节数组，定义了位图的像素。数组中的字节被组合在一起，但是每个扫描行必须用零填补，在一个 LONG 边界结束。如果高度为正的，位图的起始位置在左下角。如果高度为负，起始位置在左上角。

BITMAPINFOHEADER 结构中的 biBitCount 成员决定了定义像素的位数以及位图中的最大颜色数。这个成员可以是下列值之一：

位图是单色的， bmiColors 成员包含两个入口。位图数

组中的每一位代表一个像素。如果该位被清除，则用 bmiColors 表中的第一种颜色显示该像素。如果该位被置位，则用表中的第二种颜色显示该像素。
位图最多有 16 种颜色， bmiColors 成员中包含了最多可

达 16 个入口。位图中的每个像素用一个 4 位的值来表示，该值用作颜色表的索引。例如，如果位图中的第一个字节是 0x1F ，这个字节代表两个像素。第一个像素包含了颜色表中第二种颜色，第二个像素包含了颜色表中第十六种颜色。
位图最多有 256 种颜色， bmiColors 成员包含了多达 256 个

入口。在这种情况下，数组中的每个字节代表一个像素。
位图最多有 2 16 种颜色。 BITMAPINFOHEADER 的 biCompression 成

员必须是 BI_BITFIELDS 。 bmiColors 成员包含了 3 个 DWORD 型颜色掩码，分别代表了每个像素中的红，绿和蓝色成分。 DWORD 型掩码中的位必须是连续的，不能与其它掩码重叠。并非像素中的所有位都必须被使用。数组中的每个 WORD 值代表一个像素。
位图最多具有 2 24 种颜色， bmiColors 成员为 NULL 。位图

数组中的每个三字节组合分别代表像素中蓝，绿红的深度。
位图中最多具有 2 32 种颜色。 BITMAPINFOHEADER 中的

biCompression 成员必须是 BI_BITFIELD S。 bmiColors 成员中包含了三个 DWORD 颜色掩码，分别指定了像素的红，绿和蓝成分。 DWORD 掩码中的位必须是连续的，并且不能与其它掩码重叠。并非像素中的所有位都必须被使用。数组中的每个 DWORD 值代表一个像素。

BITMAPINFOHEADER 结构中的 biClrUsed 成员指定了颜色表中实际使用的索引的数目。如果 biClrUsed 成员被设为 0 ，位图将使用 biBitCount 成员中指定的最大颜色数。

bmiColors 表中的颜色应当按照其重要性的顺序出现。另一种情况是，对于使用 DIB 函数， bmiColors 成员可以是一个 16 位无符号整数的数组，指定了当前实现的逻辑调色板中的索引，而不是确切的 R G B 值。在这种情况下，使用位图的应用程序必须调用 W indows 的 DIB 函数（ CreateDIBitmap ， CreateDIBPatternBrush 和 CreateDIBSection ）， iUsage 参数应被设为DIB_PAL_COLOR S。

如果位图是一个压缩位图（这意味着，这种位图的数组直接跟在一个指针所引用的 BITMAPINFO 头的后面），在使用 D IB_PAL_COLORS 模式的时候， biClrUsed 成员必须被设为偶数，以便使 DIB 位图数组从 DWORD 边界开始。

注意如果位图被保存在文件中，或者要被传送到另一个应用程序， bmiColors 成员不能包含调色板索引。除非应用程序独占地使用和控制位图，位图的颜色表中应当包含准确的 RGB 值。

请参阅 CBrush::CreateDIBPatternBrush

CDaoDatabaseInfo 结构

CDaoDatabaseInfo 结构具有如下形式：

struct CDaoDatabaseInfo

{

CString m_strName; // Primary

BOOL m_bUpdatable; // Primary BOOL m_bTransactions; // Primary CString m_strVersion; // Secondary Long m_lCollatingOrder; // Secondary short m_nQueryTimeout; // Secondary CString m_strConnect; // All

};

CDaoDatabaseInfo 结构中包含了与数据库对象有关的信息，该对象是为数据访问对象（ D A O ）定义的。这个数据库对象是 CDaoDatabase 类的 MFC 对象下面的一个 DAO 对象。对上面的 Primary ， Secondary 和 A ll 的引用指明了CDaoWorkspace::GetDatabaseInfo 成员函数是如何返回信息的。

成员

m_strName

数据库对象的唯一名字。要直接获得这个属性的值，调用CDaoDatabase::GetName。有关的细节参见 DAO 帮助的 “ 名字属性 ” 主题。

m_bUpdatable

指明是否可以对数据库作出改变。要直接获得这个属性的值，调用CDaoDatabase:: CanUpdate 。有关的细节参见 DAO 帮助的 “ 可更新的属性 ” 主题。

m_bTransactions

指明一个数据源是否支持事务 — — 一系列改变的记录，以后可以被滚动回去（取消）或执行（保存）。如果数据库是基于 Microsoft Jet 数据库引擎的， Transaction 属性是非零值，你可以使用事务。其它数据库引擎可能不支持事务。要直接获取这个属性，调用

CDaoDatabase::CanTransact。有关的细节参见 DAO 帮助的 “ 事务属性 ” 主题。

m_strVersion

指明了 Microsoft Jet 数据库引擎的版本。要直接获取这个属性的值，调用数据库对象的 GetVersion 成员函数。有关的细节参见 DAO 帮助的“ 版本属性 ” 主题。

m_lCollatingOrder

指定了字符串比较或排序中使用的顺序。可能的取值包括：

dbSortGeneral 使用一般（ English ， French ， German ，
Portuguese ， Italian

和 Modern Spanish ）的排序顺序。

dbSortArabic 使用 Arabic 排序顺序。
dbSortCyrillic 使用 Russian 排序顺序。
dbSortCzech 使用 Czech 排序顺序。
dbSortDutch 使用 Dutch 排序顺序。
dbSortGreek 使用 Greek 排序顺序。
dbSortHebrew 使用 Hebrew 排序顺序。
dbSortHungarian 使用 Hungarian 排序顺序。
dbSortIcelandic 使用 Icelandic 排序顺序。
dbSortNorwdan 使用 Norwegian 或 Danish 排序顺序。
dbSortPDXIntl 使用 Paradox International 排序顺序。
dbSortPDXNor 使用 Paradox Norwegian 或 Danish 排序顺序。
dbSortPDXSwe 使用 Paradox Swedish 或 Finnish 排序顺序。
dbSortPolish 使用 Polish 排序顺序。
dbSortSpanish 使用 Spanish 排序顺序。
dbSortSwedFin 使用 Swedish 或 Finnish 排序顺序。
dbSortTurkish 使用 Turkish 排序顺序。
dbSortUndefined 使用的排序顺序未定义或未知。

更多的信息参见 DAO 帮助中的 “ 数据访问的自定义 W indows 注册表设置 ” 主题。

m_nQueryTimeout

当在 ODBC 数据库上执行一个查询时， Microsoft Jet 数据库引擎在超时错误发生前等待的秒数。缺省的超时值为 60 秒。当 QueryTimeout 被设为 0 时，不产生超时。这可能会引起程序挂起。要直接获得这个属性的值，调用数据库对象的 GetQueryTimeout 成员函数。有关的细节参见 DAO 帮助的 “ Que r yTimeout 属性 ” 主题。

m_strConnect

提供了有关打开的数据库的源的信息。有关连接字符串以及直接获取这个属性值的信息参见 CDaoDatabase::GetConnect 成员函数。更多的信息参见 DAO 帮助的 “ 连接属性 ” 主题。

注释

CDaoWorkspace::GetDatabaseInfo 成员函数所获得的信息被保存在CDaoDatabaseInfo 结构中。为 CDaoWorkspace 对象调用 GetDatabaseInfo 函数，数据库对象被保存在该对象的数据库集合中。在调试版本中， CDaoDatabaseInfo 还定义了一个 Dump 成员函数。你可以使用 Dump 来转储 CDaoDatabaseInfo 对象的内容。

有关这个结构以及其它 MFC DAO Info 结构的信息参见 “ Visual C++ 程序员指南 ” 中的文章 “ DAO 集合：获得有关 DAO 对象的信息 ” 。

请参阅 CDaoWorkspace, CDaoDatabase, CDaoWorkspace::GetDatabaseCount

CDaoErrorInfo 结构

CDaoErrorInfo 结构具有以下形式：

struct CDaoErrorInfo

{

long m_lErrorCode; CString m_strSource; CString m_strDescription; CString m_strHelpFile; long m_lHelpContext;

};

CDaoErrorInfo 结构包含了为数据访问对象（ DAO ）定义的错误对象的信息。MFC 没有将 DAO 错误对象封装为一个类。 CDaoException 类提供了访问 DAO DBEngine 对象中包含的错误集合的接口，该对象也包括了所有的工作空间。当 MFC 的 DAO 操作抛出一个你捕捉到的 CDaoException 对象时， MFC 会填充 CDaoErrorInfo 结构并将它保存在异常对象的 m_pErrorInfo 成员中。（如果你选择了直接调用 D A O ，你必须自己调用异常对象的 GetErrorInfo 函数以填充m_pErrorInfo 。）

有关处理 DAO 错误的更多信息参见“ Visual C++ 程序员指南 ” 中的文章“ 异常：数据库异常 ” 。相关的信息参见 DAO 帮助的 “ 错误对象 ” 主题。

成员

m_lErrorCode

一个数字的 DAO 错误代码。参见 DAO 帮助的“ 可捕捉的数据访问错误 ” 主题。

m_strSource

最初产生错误的对象或应用程序的名字。源属性指定了一个字符串表达式，代表最初产生错误的对象；这个表达式通常是对象的类名。有关的细节参见 DAO 帮助的 “ 源属性 ” 主题。

与错误相关的描述性字符串。有关的细节参见 DAO 帮助的 “ 描述属性 ” 主题。

m_strHelpFile

M icrosoft W indows 帮助文件的经完全验证的路径。有关的细节参见 DAO

帮助的 “ 帮助上下文，帮助文件属性 ” 主题。

m_lHelpContext

M icrosoft W indows 的帮助文件中主题的上下文 ID 。有关的细节参见 DAO

帮助的 “ 帮助上下文，帮助文件属性 ” 主题。

说明

CDaoException::GetErrorInfo 成员函数获得的信息被保存在一个 CDaoErrorInfo 结构中。在异常处理函数中检查你捕捉到的 CDaoException 对象的 m_pErrorInfo 数据成员，或者在你生成的 CDaoException 对象中调用 GetErrorInfo 函数，目的是对可能会在 DAO 接口的直接调用中产生的错误进行检查。在调试版本中， CDaoErrorInfo 还定义了一个 Dump 成员函数，可以使用 Dump 来转储CDaoErrorInfo 对象的内容。

有关这个结构和其它 MFC 的 DAO Info 结构的信息参见 “ Visual C++ 程序员指南 ” 中的文章 “ DAO 集合：获取有关 DAO 对象的信息 ” 。

CDaoFieldInfo 结构

CDaoFieldInfo 结构具有如下形式：

struct CDaoFieldInfo

{

CString m_strName; // Primary

short m_nType; // Primary

long m_lSize; // Primary

long m_lAttributes; // Primary short m_nOrdinalPosition; // Secondary BOOL m_bRequired; // Secondary BOOL m_bAllowZeroLength; // Secondary long m_lCollatingOrder; // Secondary CString m_strForeignName; // Secondary CString m_strSourceField; // Secondary CString m_strSourceTable; // Secondary CString m_strValidationRule; // All

CString m_strValidationText; // All CString m_strDefaultValue; // All

CDaoFieldInfo 结构中包含了为数据访问对象（ DAO ）定义的字段对象的信息。上面对 Primary ， Secondary 和 All 的引用指明了 CDaoTableDef， CDaoQueryDef 和 CDaoRecordset 类中的 GetFieldInfo 成员函数是如何返回信息的。

MFC 类不代表任何字段对象。相反， DAO 对象构成了下面包含字段对象集合的 MFC 类的对象： CDaoTableDef， CDaoRecordset 和 CDaoQueryDef 。这些类提供了用于访问字段信息中单个项的成员函数，也可以利用 CDaoFieldInfo 对象以及它的 GetFieldInfo 成员函数来一次访问所有的信息。

CDaoFieldInfo 不仅可以用于检查对象的属性，还可以用于构造一个输入参数，用来创建表中的新字段。对于这个任务，可以使用更简单的选项。但是要想获得更好的控制，可以使用 CDaoTableDef::CreateField 的带 CDaoFieldInfo 参数的版本。

成员

m_strName

字段对象的唯一名字。有关的细节参见 DAO 帮助中的 “ 名字属性 ” 主题。

m_nType

个指明字段数据类型的值。有关的细节参见 DAO 帮助
中的 “ 类型属

性 ” 主题。这个属性的取值可能是下列值之一：

dbBoolean 是 / 否，与 TRUE/FALSE 相同
dbByte 字节
dbInteger 短整数
dbLong 长整数
dbCurrency Currency ，参见 MFC 类 COleCurrency
dbSingle 单精度数
dbDouble 双精度数
dbDate 日期 /时间，参见 MFC 类 COleDateTime
dbText 文本，参见 MFC 类 CString
dbLongBinary 长二进制（ OLE 对象）可能你希望使用 MFC

类CByteArray 来代替 CLongBinary ，因为 CByteArray 功能更强，也更易使用
dbMemo 备注，参见 MFC 类 CString 。
dbGUID 用于远程过程调用的全局唯一的标识符。更多

的信息参见

DAO 帮助中的 “ 类型属性 ” 主题。

注意不要对二进制数据使用字符串数据类型。这会使你的数据被传递给Unicode/ANSI 转换层，导致负担增加，并且可能会导致不希望出现的转换。

m_lSize

指明了包含文本的 DAO 字段对象的最大大小，以字节为单位，或者是包含了文本或数字值的字段对象的固定大小。有关的细节参见 DAO 帮助中的 “ 大小属性 ” 主题。大小可能是下列值之一：

类型	大小（ Bytes）	描述
dbBoolean	1 字节	是 /否（与 TRUE/FALSE 相同）
dbByte	1	字节
dbInteger	2	整数
dbLong	4	长整数
dbCurrency	8	Currency（ COleCurrency）
dbSingle	4	单精度数
dbDouble	8	双精度数
dbDate dbText dbLongBinary	8 1 ～ 255 0	日期 /时间（ COleDateTim e）文本（ CString ）长二进制数据（ OLE 对象， CbyteArray ，用于代替 CLongBinary ）
dbMemo	0	备注（ CString ）
dbGUID	16	用于远程过程调用的全局唯一的标识符
m_lAttributes

指定了表定义，记录集，查询定义或索引对象中包含的字段对象的特征。返回的值可能是这些值的和，用 C++ 的位或操作符（ |）生成：

dbFixedField 字段大小是固定的（数字字段的缺省值）

。
dbVariableField 字段大小可变（仅对文本字段成立）。
dbAutoIncrField 新记录的字段值自动增加到一个唯一的

长整数，该数不能改变。仅支持 M icrosoft Jet 数据库表。
dbUpdatableField 字段的值可以改变。
dbDescending 字段按照降序（ Z ～ A 或 100 ～ 0 ）保存（仅

适用于索引对象的字段集合中的字段对象。在 MFC 中，索引对象自己就包含在表定义对象中）。如果你省略了这个常量，字段就按照升序（ A ～ Z 或 0 ～ 100 ）保存（缺省值）。

在检查这个属性的设置的时候，可以使用 C++ 的位与操作符（ & ）来测试某个指定的值。在设置多重属性的时候，可以用位或操作符（ |）把适当的常量组合起来。有关的细节参见 DAO 帮助中的 “ A ttribute 属性 ” 主题。

m_nOrdinalPosition

个指定了数字顺序的值，将按照这种顺序显示由 DAO
字段对象所代表的字段。你可以用 CDaoTableDef::CreateField 来设置这个属性。有关的细节参见 DAO 帮助中的 “ OrdinalPosition 属性 ” 主题。

m_bRequired

指明一个 DAO 字段对象是否需要非 Null 值。如果这个属性值为 TRU E ，那么这个字段不允许有 Null 值。如果 Required 被设为 FALSE ，这个字段就可以有 Null 值，也可以有符合 AllowZeroLength 和 ValidationRule 属性所指定的条件的值。有关的细节参见 DAO 帮助中的 “ Required 属

性 ” 主题。你可以使用 CDaoTableDef::CreateField 来设置这个属性。

m_bAllowZeroLength

指明对于一个文本类型或 M emo 数据类型的 DAO 字段对象，空字符串

（ “ ” ）是否是有效的值。如果这个属性为 TRUE ，空字符串就是有效值。你可以将这个属性设为 FALSE 以确保不能将这个字段的值设为空字符串。有关的细节参见 DAO 帮助中的 “ AllowZeroLength 属性 ” 主题。你可以用 CDaoTableDef::CreateField 来设置这个属性。

m_lCollatingOrder

为字符串比较和排序指定了文本顺序。有关的细节参见 DAO 帮助中的“ 为数据访问自定义 W indows 注册表设置 ” 主题。可能的返回值列表参见 CDaoDatabaseInfo 结构中的 m_lCollatingOrder 成员。你可以用CDaoTableDef::CreateField 来设置这个属性。

m_strForeignName

一个值，在关系中指定了与原始表中的字段对应的外部表中的 DAO 字段对象的名字。有关的细节参见 DAO 帮助中的 “ ForeignName 属性 ” 主题。

m_strSourceField

指定了一个字段名，是表定义，记录集或查询集对象所包含的 DAO 字段对象的数据源。例如，你可以使用这个属性来确定一个查询字段的数据源，这个字段的名字与基础表中的字段名无关。有关的细节参见 DAO

帮助中的 “ SourceField ， SourceTable 属性 ” 主题。可以用

CDaoTableDef::CreateField 来设置这个属性。

m_strSourceTable

指定了一个表名，是表定义，记录集或查询集对象的数据源。这个属性指定了与字段对象相关的原始表明。例如，你可以使用这个属性来确定一个查询字段的数据源，这个字段的名字与基础表中的字段名无关。有关的细节参见 DAO 帮助中的 “ SourceField ， SourceTable 属性 ” 主题。你可以用 CDaoTableDef::CreateField 来设置这个属性。

m_strValidationRule

当改变或增加字段的数据时用于检验数据是否有效的值。有关的细节参见 DAO 帮助中的 “ ValidationRule 属性 ” 主题。你可以用CDaoTableDef::CreateField 来设置这个属性。

有关表定义的信息参见 CDaoTableDefInfo 结构的 m_strValidationRule 成员。

m_strValidationText

一个值，指定了当 D A O 字段对象的值不符合 ValidationRule 属性所指定的有效规则时应用程序显示的消息文本。有关的细节参见 D A O 帮助中的 “ ValidationText 属性 ” 主题。你可以用 CDaoTableDef::CreateField 来设置这个属性。

m_strDefaultValue

一个 DAO 字段对象的缺省值。当创建了一个新记录时， DefaultValue 属性会被作为字段的缺省值自动输入。有关的细节参见 DAO 帮助中的“ DefaultValue 属性 ” 主题。你可以用 CDaoTableDef::CreateField 来设置这个属性。

注释

通过 GetFieldInfo 成员函数（属于包含该字段的类）获取的信息保存在CDaoFieldInfo 结构中。调用保存了字段对象的包含对象的 GetFieldInfo 成员函数。在调试版本中，CDaoFieldInfo 还定义了一个 Dump 成员函数。可以使用 Dump 来转储 CDaoFieldInfo 对象的内容。

有关这个结构以及其他 MFC DAO Info 结构的使用，参见 “ V isual C++ 程序员指南 ” 中的文章 “ DAO 集合：获取 DAO 对象的信息 ” 。

请参阅 CDaoTableDef::GetFieldInfo, CDaoRecordset::GetFieldInfo, CDaoQueryDef::GetFieldInfo

CDaoIndexInfo 结构

CDaoIndexInfo 结构具有如下形式：

struct CDaoIndexInfo {

CDaoIndexInfo( ); // Constructor

CString m_strName; // Primary CDaoIndexFieldInfo* m_pFieldInfos; // Primary short m_nFields; // Primary

BOOL m_bPrimary; // Secondary

BOOL m_bUnique; // Secondary

BOOL m_bClustered; // Secondary

BOOL m_bIgnoreNulls; // Secondary

BOOL m_bRequired; // Secondary

BOOL m_bForeign; // Secondary

long m_lDistinctCount; // A ll

// Below the // Implementation comment:

// Destructor, not otherwise documented

};

CDaoIndexInfo 结构中包含了有关为数据访问对象（ DAO ）定义的索引对象的信息。上面对 Primary ， Secondary 和 A ll 的引用指明了 C DaoTableDef 和CDaoRecordset 类的成员函数 GetIndexInfo 是符合返回信息的。

MFC 类不代表索引对象。相反， DAO 对象构成了属于 CDaoTableDef 或CDaoRecordset 类的 MFC 对象，它们包含了索引对象的集合，称为索引集合。这些类提供了用于访问索引信息的单个项的成员函数，还可以调用包含对象的GetIndexInfo 成员函数，利用 CDaoIndexInfo 对象同时访问所有项。

CDaoIndexInfo 具有一个构造函数和一个析构函数，用于适当地分配和释放

m_pFieldInfos 中的索引字段信息。

成员

m_strName

字段对象的唯一名字。有关的细节参见 DAO 帮助中的 “ Name 属性 ” 主题。

m_pFieldInfos

指向一个 CDaoIndexFieldInfo 对象数组的指针，该数组指明了表定义或记录集中哪个字段是索引的关键字段。每个对象标识了索引中的一个字段。缺省的索引顺序是升序。一个索引对象可以具有一个或多个索引关键字段。它们可以是升序，降序或其组合。

m_nFields

m_pFieldInfos 中保存的字段的数目。

m_bPrimary

如果 Primary 属性为 TRUE ，则索引对象代表一个主索引。主索引由一个或多个字段组成，这些字段可以按照给定的顺序唯一地标识表中的所有记录。由于索引字段必须是唯一的， DAO 中，索引对象的 Unique 属性也被设为 TRUE 。如果主索引由多于一个字段组成，每个字段都可以有重复的值，但是所有索引字段取值的组合必须是唯一的。主索引由表

的关键字组成，通常包含了与主键中相同的字段。

当为一个表设置主键的时候，主键被自动设为表的主索引。更多的信息参见 DAO 帮助中的 “ Primary 属性 ” 和 “ Unique 属性 ” 主题。

注意每个表最多只能有一个主索引。

m_bUnique

指明一个索引对象是否是表的唯一索引。如果这个属性为 TRUE ，那么这个索引对象代表了唯一的索引。唯一的索引由表中的一个或多个字段组成，它们在逻辑上将表中的所有记录按照给定的唯一顺序排列起来。如果这个索引由一个字段组成，这个字段中的值必须是独立的。如果索引由多个字段组成，那么每个字段都可以有重复的值，但是它们的组合必须是唯一的。

如果索引的 Unique 和 Primary 属性都被设为 TRUE ，那么这个索引是主索引，并且是唯一的。他按照给定的逻辑顺序唯一地标识了表中的所有记录。如果 Primary 属性被设为 FALSE ，这个索引是次索引。次索引（关键索引或非关键索引）按照给定的顺序在逻辑上排列表中的记录，但是并不能作为表中记录的标识使用。

更多的信息参见 DAO 帮助中的“ Primary 属性”和 “ Unique 属性 ” 主题。

m_bClustered

指明一个索引对象是否代表一个表的成簇索引。如果这个顺序被设为

TRUE ，那么索引对象代表成簇索引，否则就不是。成簇索引由一个或多个非关键字段组成，它们一起按照给定的顺序排列表中的所有记录。有了成簇索引，表中的数据将按照索引指定的顺序存储。成簇索引提供了访问数据的有效方式。更多的信息参见 DAO 帮助中的 “ Clustered 属性 ” 主题。

注意对于使用 Microsoft Jet 数据库引擎的数据库， Clustered 属性会被忽略，因为 Jet 数据库引擎不支持成簇索引。

m_bIgnoreNulls

指明是否有记录的索引项在它们的索引字段中包含 Null 值。如果这个属性为 TRUE ，具有 Null 值的字段就没有索引项。如果要使对记录的查找更快速，可以为这个字段定义索引。如果你允许建立索引的字段中包含Null 值，并且可能有许多项为 Null ，可以把索引对象的 IgnoreNulls 属性设为 TRUE 以减小索引使用的存储空间。 IgnoreNulls 属性和 Required 属性的设置共同决定了一个具有 Null 索引值的记录是否具有索引项，如下面的表格所示：

IgnoreNulls	Required	索引字段中的 Null
True	False	允许有 Null 值，但没有索引项
False	False	允许有 Null 值，有索引项
True 或 False	True	不允许有 Null 值，没有索引项

更多的信息参见 DAO 帮助中的 “ IgnoreNulls 属性 ” 主题。

m_bRequired

指明一个 DAO 索引对象是否要求非 Null 值。如果这个属性为 TRU E ，那么索引对象不允许有 Null 值。更多的信息参见 DAO 帮助中的“ Required 属性 ” 主题。

Tip

当你能够为 D A O 索引对象或字段对象（被表定义，记录集或查询定义对象所包含）设置这个属性的时候，就为字段对象设置这个属性。为字段对象设置的属性的有效性检查将在索引对象之前进行。

m_bForeign

指明索引对象是否代表了表中的一个外部关键字。如果这个属性为TRUE ，则索引对象代表了表中的外部关键字。外部关键字由外部表中的一个或多个字段组成，他唯一确定了主表中的行。当你创建一个要求引用完整性的关系时， M icrosoft Jet 数据库引擎为外部表创建一个索引对象并设置 Foreign 属性。更多的信息参见 DAO 帮助中的 “ Foreign 属性 ” 主题。

m_lDistinctCount

指定了相关表中包含的索引对象的唯一值的数目。检查 DistinctCount 属性以确定索引中唯一值或键的数目。每个键只被计数一次，即使在索引允许重复值时，它们多次出现。这个信息对于试图通过统计索引信息来优化数据访问的应用程序非常有用。唯一值的数目还被当作索引对象的

势。 D istinctCount 属性并不总是反映某一时刻关键字的数目。例如，由于取消事务所引起的改变不会被 DistinctCount 属性立即反映。更多的信息参见 D A O 帮助中的 “ DistinctCount 属性 ” 主题。

注释

用表定义对象的 GetIndexInfo 成员函数获得的信息被保存在 CDaoIndexInfo 结构中。调用包含了索引对象的表定义对象的 GetIndexInfo 成员函数。在调试版本中 CDaoIndexInfo 还定义了一个 Dump 成员函数。你可以使用 Dump 来转储CDaoIndexInfo 对象的内容。

有关这个结构以及其他 MFC DAO Info 结构的使用，参见 “ V isual C++ 程序员指南 ” 中的文章 “ DAO 集合：获取 DAO 对象的信息 ” 。

请参阅 CDaoTableDef::GetIndexInfo

CDaoIndexFieldInfo 结构

CDaoIndexFieldInfo 结构具有如下形式：

struct CDaoIndexFieldInfo

{

CString m_strName; // Primary

BOOL m_bDescending; // Primary

};

CDaoIndexFieldInfo 结构中包含了为数据访问对象（ DAO ）定义的索引字段对象的信息。索引对象可以有多个字段，指明表定义（或基于表的记录集）的索引建立在哪些字段上。上面对 Primary 的引用指明了调用 CDaoTableDef 或CDaoRecordset 类的 GetIndexInfo 成员函数时获得的信息是如何通过CDaoIndexInfo 对象的 m_pFiledInfos 成员返回的。

MFC 类不代表索引对象和索引字段对象。相反，DAO 对象构成了 CDaoTableDef 或 CDaoRecordset 类的 MFC 对象，这些对象中包含了索引对象的集合，名为索引集。每个索引对象包含了一个字段对象的集合。这些类提供了用于访问索引信息中单个项的成员函数，你也可以通过调用包含对象的 GetIndexInfo 成员函数在 CDaoIndexInfo 对象中访问所有的项。 CDaoIndexInfo 中具有一个数据成员 m_pFieldInfos，它指向一个 CDaoIndexFieldInfo 对象的数组。

成员

m_strName

索引字段对象的唯一的名字。有关的细节参见 DAO 帮助中的 “ Name 属性 ” 主体。

m_bDescending

指明了索引对象定义的索引顺序。如果顺序是降序的则该成员的值为

TRUE 。

注释

调用表定义或记录集对象的 GetIndexInfo 成员函数，你感兴趣的索引对象就保存在这些对象的索引集中。然后访问 CDaoIndexInfo 对象的 m_pFieldInfos 成员。m_pFieldInfos 数组的长度保存在 m_nFields 中。 CDaoIndexFieldInfo 还在调试版本中定义了一个 Dump 函数。你可以使用 Dump 来转储 CDaoIndexFieldInfo 对象的内容。

有关这个结构以及其他 MFC DAO Info 结构的使用参加 “ Visual C++ 程序员指南 ” 中的文章 “ DAO 集合：获取 DAO 对象的信息 ” 。

请参阅 CDaoTableDef::GetIndexInfo, CDaoRecordset::GetIndexInfo

CDaoParameterInfo 结构

CDaoParameterInfo 结构具有如下形式：

struct CDaoParameterInfo

{

CString m_strName; // Primary

short m_nType; // Primary

C O leVariant m_varValue; // Secondary

};

CDaoParameterInfo 结构中包含了为数据访问对象（ D A O ）定义的参数对象的信息。上面对 Primary 和 Secondary 的引用指明了 CDaoQueryDef 类的成员函数GetParameterInfo 是如何返回信息的。

MFC 没有把 DAO 参数对象封装为一个类。 DAO 查询对象构成了 MFC 的CDaoQueryDef 对象的基础，在它们的参数集中保存了参数。要访问CDaoQueryDef 对象中的参数对象，就调用查询定义对象的成员函数GetParameterInfo ，可以获得特点的参数名或是参数集的索引。你可以与GetParameterInfo 一起使用 CDaoQueryDef::GetParameterCount 函数，以在参数集中循环。

成员

m_strName

参数对象的唯一的名字。更多的信息参见 DAO 帮助中的 “ Name 属性 ” 主题。

m_nType

指明了参数对象的数据类型的值。可能取值的列表参见 CDaoFieldInfo 结构的 m_nType 成员。更多的信息参见 DAO 帮助中的“ Type 属性 ” 主题。

m_varValue

参数的值，保存在 COleVariant 对象中。

注释

通过成员函数 CDaoQueryDef::GetParameterInfo 获得的信息保存在CDaoParameterInfo 结构中。为查询定义对象调用 GetParameterInfo 函数，这些对象的参数集中保存了参数对象。

注意如果你希望得到或设置参数的值，使用 CDaoRecordset 类的GetParamValue 和 SetParamValue 成员函数。

CDaoParameterInfo 还为调试模式定义了一个 Dump 成员函数。你可以使用 Dump 来转储 CDaoParameterInfo 对象的内容。关于这个结构以及其他 MFC DAO Info 结构的使用参见 “ Visual C++ 程序员指南 ” 中的文章 “ DAO 集合：获得 DAO 对象的信息 ” 。

请参阅 CDaoQueryDef

CDaoQueryDefInfo 结构

CDaoQueryDefInfo 结构具有如下形式：

struct CDaoQueryDefInfo

{

CString m_strName; // Primary

short m_nType; // Primary

COleDateTime m_dateCreated; // Secondary COleDateTime m_dateLastUpdated; // Secondary BOOL m_bUpdatable; // Secondary

BOOL m_bReturnsRecords; // Secondary

CString m_strSQL; // A ll

CString m_strConnect; // All

short m_nODBCTimeout; // A ll

};

CDaoQueryDefInfo 结构包含了为数据访问对象（ DAO ）定义的查询定义对象的信息。查询定义对象是 CDaoQueryDef 类的对象。上面对 Primary， Secondary 和 A ll 的引用指明了 CDaoDatabase 类的成员函数 GetQueryDefInfo 是如何返回信息的。

成员

m_strName

查询定义对象的唯一的名字。更多的信息参见 DAO 帮助中的 “ Name 属性 ” 主题。调用 CDaoQueryDef::GetName 以直接访问这个属性。

m_nType

指明了查询定义对象的操作类型的值。其取值可能是下列值之一：

dbQSelect Select — 该查询选择记录。
dbQAction Action — 该查询移动或改变数据，但是不返回

记录。
dbQCrosstab Crosstab — 该查询用与电子表格类似的格式返

回数据。
dbQDelete Delete — 该查询删除指定的行。
dbQUpdate Update — 该查询更新一些记录。
dbQAppend Append — 该查询在表或查询的尾部加入新记录

。
dbQMakeTable Make-table — 该查询根据记录集创建一个新表

。
dbQDDL Data-definition — 该查询影响表格及其部分的结构

。
dbQSQLPassThrough Pass-through — 直接把 SQL 语句传递给数据库

，没有中间处理。
dbQSetOperation Union — 该查询创建一个快照型记录集对象

，其中包含了一个或多个表中指定记录的数据，所有重复的记录都被删除。如果要包含重复记录，在查询定义的 SQL 语句中加入 ALL 关键字。
dbQSPTBulk 与 dbQSQLPassThrough 一起使用，指定了一种不返

回记录的查询。

注意在创建一个直接传递 SQL 的查询时，你不需要设置dbQSQLPassThrough 常量。它是在创建查询定义对象并设置连接属性的时候由 Microsoft Jet 数据库引擎自动设置的。

更多的信息参见 DAO 帮助中的 “ Type 属性 ” 主题。

m_dateCreated

创建查询定义的日期和时间。如果要直接获得创建查询定义的日期，调用与表相关的 CDaoTableDef 对象的成员函数 GetDateCreated。更多的信

息参见下面的注释。还可以参看 DAO 帮助中的“ DateCreated ，LastUpdated

属性 ” 主题。

m_dateLastUpdated

最近一次对查询定义作出改变的日期和时间。如果要直接获得最近改变表的日期，调用查询定义的成员函数 GetDateLastUpdated 。更多的信息参见下面的注释。同时参看 DAO 帮助中的 “ DateCreated ， LastUpdated 属性 ” 主题。

m_bUpdatable

指明是否可以修改查询定义对象。如果这个属性为 TRUE ，查询定义可以被修改；否则不能。可以被修改意味着查询定义对象的查询定义可以被修改。如果查询定义可以被修改，则查询定义对象的 Updatable 属性被设为 TRU E ，即使结果记录集不能被修改。如果要直接获得这个属性的值，调用查询定义对象的 CanUpdate 成员函数。更多的信息参见 DAO 帮助中的 “ Updatable 属性 ” 主题。

m_bReturnsRecords

指明一个直接将 SQL 传递给外部数据库的查询是否返回记录。如果这个属性为 TRU E ，该查询返回记录。如果要直接获得这个属性的值，调用CdaoQuery- Def::GetReturnsRecords。并不是所有直接将 SQL 传递给外部数据库的查询都返回记录。例如， SQL UPDATE 语句更新记录，但不返回语句，而 SQL SELECT 语句却返回语句。更多的信息参见 D A O 帮助

m_strSQL

定义了查询定义对象所执行的查询的 SQL 语句。 SQL 属性中包含了 S Q L 语句，决定了执行查询时记录如何被选择，分组或排序。你可以使用该查询把记录选择到一个 dynaset 类型或 snapshot 类型的记录集对象。你也可以定义一个批查询来修改数据而不返回记录。你可以调用查询定义的GetSQL 成员函数来直接获得这个属性的值。更多的信息参见“ V isual C++ 程序员指南 ” 中的文章 “ DAO 查询 ” 以及 DAO 帮助中的 “ SQL 属性 ” 主题。

m_strConnect

提供了用于直接传递查询的数据库源的信息。这个信息采用连接字符串的形式。有关连接字符串以及直接获得这个属性值的更多信息参见CDaoDatabase::GetConnect 成员函数。

m_nODBCTimeout

当在一个 ODBC 数据库上运行一个查询时，在产生一个超时错误之前， M icrosoft Jet 数据库引擎将等待的秒数。当你使用 ODBC 数据库的时候，例如 M icrosoft SQL Server，可能会因为网络阻塞或是 ODBC 服务器的重负而引起延迟。为了避免无限等待，你可以指定 M icrosoft Jet 数据库引擎在产生错误前等待多长时间。缺省的超时值为 60 秒。你可以调用查询定义的 GetODBCTimeout 成员函数来直接获得这个属性的值。更多的信

注释

CDaoDatabase::GetQueryDefInfo 成员函数获得的信息被保存在CDaoQueryDefInfo 结构中。调用数据库对象的 GetQueryDefInfo 函数，查询定义对象就保存在该对象的查询定义集合中。 CDaoQueryDefInfo 还为调试版本定义了一个 Dump 成员函数。你可以利用 Dump 来转储 CDaoQueryDefInfo 对象的内容。 CDaoDatabase 类也提供了用于直接访问 CDaoQueryDefInfo 对象所返回的所有属性的成员函数，因此你可能很少需要调用 GetQueryDefInfo 。

当你在查询定义对象的字段集合或参数集合中加入新的字段或参数时，如果基础数据库不支持新对象所指定的数据类型，就会抛出一个异常。

日期和时间设置是从创建查询定义或最后修改查询定义的计算机上获得的。在多用户环境中，用户应当直接使用 net time 命令从文件服务器上获得这些设置，以避免 DateCreated 和 LastUpdated 属性中的不一致。有关这个结构和其他 MFC DAO Info 结构的信息参见 “ Visual C++ 程序员指南 ” 中的文章 “ D A O 集合：获得 DAO 对象的信息 ” 。

请参阅 CDaoQueryDef, CDaoDatabase

CDaoRelationInfo 结构

CDaoRelationInfo 结构具有如下形式：

struct CDaoRelationInfo

{

CDaoRelationInfo( ); // Constructor CString m_strName; // Primary

CString m_strTable; // Primary

CString m_strForeignTable; // Primary

long m_lAttributes; // Secondary CDaoRelationFieldInfo* m_pFieldInfos; // Secondary short m_nFields; // Secondary

// Below the // Implementation comment:

// Destructor, not otherwise documented

};

CDaoRelationInfo 结构中包含了在 CDaoDatabase 对象的两个表之间定义的关系的信息。上面对 Primary 和 Secondary 的引用指明了 CDaoDatabase 类的成员函数 GetRelationInfo 是如何返回信息的。

MFC 类不代表关系对象。相反， DAO 对象构成了 CDaoDatabase 类的 MFC 对象，它维护着一个关系对象的集合： CDaoDatabase 提供了用于访问关系信息中一些单独项的成员函数，也可以调用包容数据库对象的 GetRelationInfo 成员函

数，通过 CDaoRelationInfo 结构同时访问所有的信息。

成员

m_strName

关系对象的唯一名字。更多的信息参见 DAO 帮助中的 “ Name 属性 ” 主题。

m_strTable

命名关系中的主表。

m_strForeignTable

命名关系中的外部表。外部表是用于包含外部关键字的表。通常，可以利用外部表来建立或强化引用完整性。外部表通常位于一对多关系中多的一方。外部表的例子有包含以下内容的表：美国州代码或加拿大的省或顾客的订货。

m_lAttributes

包含了有关关系类型的信息。这个成员的值可以是下列值中的任何一个：

dbRelationUnique 一对一关系。
dbRelationDontEnforce 关系是非强迫的的。（没有引用完

整性）
dbRelationInherited 关系存在于非当前数据库中，其中包

含了两个相连的表。
dbRelationLeft 关系是左连接的。左外部连接包含了两个

表中第一个

（左边）表的所有记录，即使在第二个表（右边）中没有与之匹配的值。

dbRelationRight 关系是右连接的。右的外部连接包含了
两个表中第二

个（右边）表的所有记录，即使在第一个表（左边）中没有与之匹配的值。

dbRelationUpdateCascade 更新操作是重叠的。
dbRelationDeleteCascade 删除操作是重叠的。

m_pFieldInfos

指向 CDaoRelationFieldInfo 结构数组的指针。对于关系中的每个字段，该数组中都包含一个对象。 m_nFields 数据成员给出了数组元素的个数。

m_nFields

m_pFieldInfos 数据成员中 CDaoRelationFieldInfo 对象的个数。

注释

通过 CDaoDatabase::GetRelationInfo 成员函数获取的信息被保存在CDaoRelationInfo 结构中。 CDaoRelationInfo 还在调试版本中定义了一个 Dump 成员函数。你可以使用 Dump 来转储 CDaoRelationInfo 对象的内容。有关这个结构以及其他 MFC DAO Info 结构的信息参见 “ V isual C++ 程序员指南 ” 中的文章 “ DAO 集合：获取 DAO 对象的信息 ” 。

CDaoRelationFieldInfo 结构

CDaoRelationFieldInfo 结构具有如下形式：

struct CDaoRelationFieldInfo

{

CString m_strName; // Primary CString m_strForeignName; // Primary

};

CDaoRelationFieldInfo 结构中包含了为数据访问对象（ DAO ）定义的关系中的字段的信息。 DAO 关系对象指定了定义关系的主表中的字段和外部表中的字段。在上面的结构定义中对 Primary 的引用指明了调用 CDaoDatabase 类的成员函数 GetRelationInfo 获得的信息是如何在 CDaoRelationInfo 对象的m_pFieldInfos 成员中返回的。

MFC 类不代表任何关系对象和关系字段对象。相反， DAO 对象构成了CDaoDatabase 类的 MFC 对象，其中包含了关系对象的集合，称为关系集合。每个关系对象包含了一个关系对象的集合。每个关系对象使主表中的字段和外部表中的字段产生联系。合在一起，关系字段对象定义了每个表中的一组字段，它们一起定义了关系。 CDaoDatabase 使你能够调用 GetRelationInfo 成员函数通

据成员 m_pFieldInfo s，它指向一个 CDaoRelationFieldInfo 对象的数组。

成员

m_strName

关系的主表中字段的名字。

m_strForeignName

关系的外部表中字段的名字。

注释

调用包容的 CDaoDatabase 对象的 GetRelationInfo 成员函数，你感兴趣的关系对象就保存在该对象的关系集合中。然后访问 CDaoRelationInfo 对象的m_pFieldInfos 成员。 CDaoRelationFieldInfo 还在调试版本中定义了一个 Dump 函数。你可以使用 Dump 来转储 CDaoRelationFieldInfo 对象的内容。

有关这个结构以及其他 MFC DAO Info 结构的信息参见 “ V isual C++ 程序员指南 ” 中的文章 “ DAO 集合：获得 DAO 对象的信息 ” 。

请参阅 CDaoRelationInfo

CDaoTableDefInfo 结构

CDaoTableDefInfo 结构具有如下形式：

struct CDaoTableDefInfo

{

CString m_strName; // Primary

BOOL m_bUpdatable; // Primary

long m_lAttributes; // Primary COleDateTime m_dateCreated; // Secondary COleDateTime m_dateLastUpdated; // Secondary CString m_strSrcTableName; // Secondary CString m_strConnect; // Secondary CString m_strValidationRule; // A ll

CString m_strValidationText; // All long m_lRecordCount; // A ll

};

CDaoTableDefInfo 结构中包含了为数据访问对象（ DAO ）定义的表定义对象的信息。表定义是 CDaoTableDef 类的对象。上面对 Primary， Secondary 和 All 的引用指明了在 CDaoDatabase 类的成员函数 GetTableDefInfo 中信息是如何返回的。

成员

m_strName

表定义对象的唯一的名字。如果要直接获得这个属性的值，调用表定义对象的 GetName 成员函数。更多的信息参见 D A O 帮助中的 “ Name 属性 ” 主题。

m_bUpdatable

指明是否可以修改表。确定一个表可以修改的最快的方式是否为这个表打开一个 CDaoTableDef 对象，然后调用这个对象的 CanUpdate 成员函数。对于一个新创建的表定义对象，CanUpdate 总是返回非零值（ TRUE ），对于连接的表定义对象则返回 0 （ FALSE ）。一个新创建的表定义对象仅能被附加到一个用户具有写权限的数据库。如果该表仅包含不可更新的字段，CanUpdate 返回 0 。当有一个或多个字段可以被更新时，CanUpdate 返回非零值。你只能编辑可更新的字段。更多的信息参见 D A O 帮助中的 “ Updatable 属性 ” 主题。

m_lAttributes

指定了表定义对象所代表的表的特征。如果要获得表定义的当前属性，调用它的成员函数 GetAttributes 。返回值可能是下面这些值的组合（使用位或操作符 |）：

dbAttachExclusive 对于使用 M icrosoft Jet 数据库引擎的数据
库，指明

这个表是一个独占使用的表。

dbAttachSavePWD 对于使用 M icrosoft Jet 数据库引擎的数据
库，指明连接的表的用户 ID 和密码被保存在连接信息中。

dbSystemObject	指明这个表是由	M icrosoft	Jet 数据库引擎提供的系统
表（只读）。
dbHiddenObject	指明这个表是由	M icrosoft	Jet 数据库引擎提供的隐含
表（只读）。

dbAttachedTable 指明这个表是非 ODBC 数据库，例如 Paradox

数据库的一个连接表。
dbAttachedODBC 指明这个表是 ODBC 数据库，例如 M icrosoft

SQL Server 数据库的一个连接表。

m_dateCreated

创建表的日期和时间。如果要直接获得创建表的日期，调用与该表相关的 CDaoTableDef 对象的 GetDateCreated 成员函数。更多的信息参见下面的注释。相关信息参见 DAO 帮助中的 “ DateCreated ， LastUpdated 属性 ” 主题。

m_dateLastUpdated

最近对表的设计作出改变的日期和时间。如果要直接获取该表最近被修改的日期，调用与该表相关的 CDaoTableDef 对象的 GetDateLastUpdated 成员函数。更多的信息参见下面的注释。相关的信息参见 D A O 帮助中的 “ DateCreated ， LastUpdated 属性 ” 主题。

m_strSrcTableName

指定了连接表的名字，如果有的话。如果要直接获得源表的名字，调用与表相关的 CDaoTableDef 对象的 GetSourceTableName 成员函数。

m_strConnect

提供了与打开的数据库源有关的信息。你可以调用 CDaoTableDef 对象的成员函数 GetConnect 来检查这个属性。有关连接字符串的更多信息参见 GetConnec t。

m_strValidationRule

当表定义字段中的数据被改变或加入一个表中时，这个值被用来校验数据。校验仅支持使用 M icrosoft Jet 数据库引擎的数据库。如果要直接获得校验规则，调用与该表相关的 CDaoTableDef 对象的 GetValidationRule 成员函数。相关的信息参见 DAO 帮助中的 “ Validation 属性 ” 主题。

m_strValidationText

指定了当 ValidationRule 属性所指定的校验规则不被满足时，应用程序要显示的消息文本。相关的消息参见 DAO 帮助中的 “ ValidationText 属性 ” 主题。

m_lRecordCount

在表定义对象中访问的记录数目。这个属性是只读的。如果要直接获取记录的计数，调用 CDaoTableDef 对象的 GetRecordCount 成员函数。GetRecordCount 的文档进一步描述了记录计数。注意如果表中有很多记

录，要获得这个计数可能耗去很多时间。

注释

CDaoDatabase::GetTableDefInfo 成员函数获得的信息被保存在CDaoTableDefInfo 结构中。调用 CDaoDatabase 结构的 GetTableDefInfo 成员函数，表定义对象就保存在的 TableDefs 集合中。 CDaoTableDefInfo 还在调试版本中定义了一个 Dump 成员函数。你可以使用 Dump 来转储 CDaoTableDefInfo 对象的内容。

日期和时间设置是从基表被创建或修改的计算机上获得的。在多用户环境中，用户应该直接从文件服务器获得这些设置以避免 DateCreated 和 LastUpdated 属性产生不一致。

有关这个结构和其他 MFC DAO Info 结构的信息参见“ V isual C++ 程序员指南 ” 中的文章 “ DAO 集合：获得 DAO 对象的信息 ” 。

请参阅 CDaoTableDef, CDaoDatabase, CDaoTableDef::CanUpdate, CDaoTableDef::GetAttributes, CDaoTableDef::GetDateCreated, CDaoTableDef::GetDateLastUpdated, CDaoTableDef::GetRecordCount, CDaoTableDef::GetSourceTableName,

CDaoTableDef::GetValidationRule, CDaoTableDef::GetValidationText

CDaoWorkspaceInfo 结构

CDaoWorkspaceInfo 结构具有如下形式：

struct CDaoWorkspaceInfo

{

CString m_strName; // Primary CString m_strUserName; // Secondary BOOL m_bIsolateODBCTrans; // A ll

};

CDaoWorkspaceInfo 结构中包含了为使用数据访问对象（ D A O ）的数据库访问而定义的工作空间的信息。工作空间是 CDaoWorkspace 类的对象。上面对Primary，Secondary 和 A ll 的引用指明了 CDaoWorkspace 类的 GetWorkspaceInfo 成员函数是如何返回信息的。

成员

m_strName

工作空间的唯一名字。如果要直接获得这个属性值，调用查询定义对象的 GetName 成员函数。更多的信息参见 DAO 帮助中的 “ Name 属性 ” 主题。

m_strUserName

代表了工作空间对象的拥有者的值。相关的信息参见 DAO 帮助中的“ UserName 属性 ” 主题。

m_bIsolateODBCTrans

指明了涉及同一个 ODBC 数据库的多用户事务是否被隔离。更多的信息参见 CDaoWorkspace::SetIsolateODBCTran s。相关的信息参见 D A O 帮助中的 “ IsolateODBCTrans 属性 ” 主题。

注释

CDaoWorkspace::GetWorkspaceInfo 成员函数获取的信息被保存在CDaoWorkspaceInfo 结构中。 CDaoWorkspaceInfo 还在调试版本中定义了一个Dump 成员函数。你可以使用 Dump 来转储 CdaoWorkspaceInfo 对象的内容。有关这个对象和其他 MFC DAO Info 结构的信息参见“ V isual C++ 程序员指南 ” 中的文章 “ DAO 集合：获得 DAO 对象的信息 ” 。

请参阅 CDaoWorkspace

CODBCFieldInfo 结构

CODBCFieldInfo 结构具有如下形式：

struct CODBCFieldInfo

{

CString m_strName; SWORD m_nSQLType; U D W O R D m_nPrecision; SWORD m_nScale; SWORD m_nNullability;

};

CODBCFieldInfo 结构中包含了 ODBC 数据源中字段的有关信息。如果要获得这个信息，调用 CRecordset::GetODBCFieldInfo 。

成员

m_strName

字段的名字。

m_nSQLType

字段的 SQL 数据类型。它可以是 ODBC SQL 数据类型或驱动程序特定的 SQL 数据类型。有效的 ODBC SQL 数据类型的列表参见“ ODBC SDK 程序员参考 ”的附录 D 中的“ SQL 数据类型 ”。有关驱动程序特定的 S Q L 数据类型的信息参看驱动程序的文档。

m_nPrecision

字段的最大精度。有关的细节参见 “ ODBC SDK 程序员参考 ” 的附录 D

中的 “ 精度，范围，长度和显示大小 ” 。

m_nScale

字段的范围。有关的细节参见 ODBC SDK 程序员参考的附录 D 中的“ 精度，范围，长度和显示大小 ” 。

m_nNullability

一个字段是否允许 Null 值。它可以是两个值之一：如果该字段允许 Null 值，则为 SQL_NULLABLE ；如果该字段不允许 Null 值，则为SQL_NO_NULLS 。

请参阅 CRecordset::GetODBCFieldInfo, CRecordset::GetFieldValue

COLORADJUSTMENT 结构

COLORADJUSTMENT 结构具有如下形式：

typedef struct tagCOLORADJUSTMENT { /* ca */ WORD caSize;

WORD caFlags;

WORD caIlluminantIndex; WORD caRedGamma; WORD caGreenGamma; WORD caBlueGamma; WORD caReferenceBlack;

WORD caReferenceWhite; SHORT caContrast;

SHORT caBrightness; SHORT caColorfulness; SHORT caRedGreenTint;

} COLORADJUSTMENT;

COLORADJUSTMENT 结构定义了当 StretchBlt 模式为 HALFTONE 时，W indows

的 StretchBlt 和 StretchDIBits 函数使用的颜色调整值。

成员

caSize

指定了该结构以字节为单位的大小。

caFlags

指定了如何准备输出图象。这个成员可以被设为 NULL 或是下列值的组合：

CA_NEGATIVE 指定了要显示原图的反相图。
CA_LOG_FILTER 指定了一个对数函数，将对输出颜色的

最后深度起作用。当亮度较低时，这将增加颜色的对比度。

caIlluminantIndex

指定了光源的亮度，图象将在该光源下显示。这个成员可以被设为下列值中的一个：

ILLUMINANT_EQUAL_ENERGY
ILLUMINANT_A
ILLUMINANT_B
ILLUMINANT_C
ILLUMINANT_D50
ILLUMINANT_D55
ILLUMINANT_D65
ILLUMINANT_D75
ILLUMINANT_F2
ILLUMINANT_TURNGSTEN
ILLUMINANT_DAYLIGHT
ILLUMINANT_FLUORESCENT
ILLUMINANT_NTSC

caRedGamma

指定了原色中红原色的 n 次 gamma 修正值。这个值必须介于 2500 ～ 65000

之间。如果值等于 10000 ，则意味着没有 gamma 修正。

caGreenGamma

指定了原色中绿原色的 n 次 gamma 修正值。这个值必须介于 2500 ～ 65000

之间。如果值等于 10000 ，则意味着没有 gamma 修正。

caBlueGamma

指定了原色中蓝原色的 n 次 gamma 修正值。这个值必须介于 2500 ～ 65000

之间。如果值等于 10000 ，则意味着没有 gamma 修正。

caReferenceBlack

指定了源色的黑色参考值。任何比这个值暗的颜色被当作黑色。这个值必须介于 0 ～ 4000 之间。

caReferenceWhite

指定了源色的白色参考值。任何比这个值亮的颜色被当作白色。这个值必须介于 6000 ～ 10000 之间。

caContrast

指定了对源对象应用的对比度值。这个值必须介于－ 100 ～ 100 之间。如果该值为 0 则意味着没有对比度调整。

caBrightness

指定了对源对象应用的亮度值。这个值必须介于－ 100 ～ 100 之间。如果该值为 0 ，则意味着没有亮度调整。

caColorfulness

指定了对源对象应用的饱和度值。这个值必须介于－ 100 ～ 100 之间。如果该值为 0 ，则意味着没有饱和度调整。

caRedGreenTint

指定了应用于源对象的红或绿校正值。这个值必须介于－ 100 ～ 100 之间。正数将会向红色调整，而负数将会向绿色调整。如果这个值为 0 ，则意味着没有调整。

请参阅 CDC::GetColorAdjustment

COMPAREITEMSTRUCT 结构

COMPAREITEMSTRUCT 数据结构具有这种形式：

typedef struct tagCOMPAREITEMSTRUCT { UINT CtlType;

UINT CtlID;

HWND hwndItem; UINT itemID1; DWORD itemData1; UINT itemID2; DWORD itemData2;

} COMPAREITEMSTRUCT;

COMPAREITEMSTRUCT 结构为有序的自画列表框或组合框中的两项提供了标识符和来自应用程序的数据。当应用程序在用 CBS_SORT 或 LBS_SORT 风格

创建的自画列表框或组合框中加入一个新项时， W indows 将给拥有者发送一个WM_COMPAREITEM 消息。这个消息的 lParam 参数中包含了指向COMPAREITEMSTRUCT 结构的长指针。通过接收这个消息，拥有者比较这个两个项并返回一个值，指明哪一项在前。

成员

CtlType

ODT_LISTBOX （这指定了一个自画列表框）或 ODT_COMBOBOX （这指定了一个自画组合框）。

CtlID

列表框或组合框的控制 ID 。

hwndItem

控件的窗口句柄。

itemID1

将要比较的列表框或组合框中第一项的索引。

itemData1

应用程序为要比较的第一项提供的数据。这个值在把这个项加入组合框或列表框时给定。

itemID 2

将要比较的列表框或组合框中第二项的索引。

itemData2

应用程序为要比较的第二项提供的数据。这个值在把这个项加入组合框或列表框时给定。

请参阅 CWnd::OnCompareItem

CREATESTRUCT 结构

CREATESTRUCT 结构具有如下形式：

typedef struct tagCREATESTRUCT { LPVOID lpCreateParams; HANDLE hInstance; HMENU hMenu;

HWND hwndParent;

int cy;

int cx;

int y;

int x;

LONG style;

LPCSTR lpszName;

LPCSTR lpszClass;

DWORD dwExStyle;

} CREATESTRUCT;

CREATESTRUCT 结构定义了传递给应用程序的窗口过程的初始化参数。

成员

lpCreateParams

指向将被用于创建窗口的数据的指针。

hInstance

标识了拥有新窗口的模块的模块实例的句柄。

hMenu

标识了要被用于新窗口的菜单。如果是子窗口，则包含整数 ID 。

hwndParent

标识了拥有新窗口的窗口。如果新窗口是一个顶层窗口，这个参数可以为 NULL 。

指定了新窗口的高。

指定了新窗口的宽。

style

指定了新窗口的左上角的 y 轴坐标。如果新窗口是一个子窗口，则坐标是相对于父窗口的；否则坐标是相对于屏幕原点的。

指定了新窗口的左上角的 x 轴坐标。如果新窗口是一个子窗口，则坐标是相对于父窗口的；否则坐标是相对于屏幕原点的。

指定了新窗口的风格。

lpszName

指向一个以 null 结尾的字符串，指定了新窗口的名字。

lpszClass

指向一个以 null 结尾的字符串，指定了新窗口的 W indows 类名（一个

WNDCLASS 结构；更多的信息参见 W in32 SDK 文档）。

dwExStyle

指定了新窗口的扩展风格。

请参阅 CWnd::OnCreate

DELETEITEMSTRUCT 结构

DELETEITEMSTRUCT 结构具有如下形式：

typedef struct tagDELETEITEMSTRUCT { /* ditms */ UINT CtlType;

UINT CtlID;

UINT itemID;

H W N D hwndItem;

UINT itemData;

} DELETEITEMSTRUCT;

DELETEITEMSTRUCT 结构指定一个被删除的自画列表框或组合框项。当从列表框或组合框中删除一项或当列表框或组合框被销毁时，对于被删除的每一项， W indows 向它的拥有者发送 WM_DELETEITEM 消息。消息的 lParam 参数包含指向这个结构的指针。

成员

CtlType

是 ODT _LISTBOX （对于自画列表框）或 ODT_COMBOBOX （对于自画组合框）。

CtlID

itemID

指定列表框或组合框的标识符。

指定将被删除的项在列表框或组合框中的索引。

hwndItem

控件的标识符。

itemData

指定程序定义的与该项相关的数据。此值通过消息的 lParam 参数传递给控件，而这一消息向列表框或组合框中增加项。

请参阅 CWnd::OnDeleteItem

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

指定了驱动程序支持的设备名称；例如，对于 P C L /H P L a se r J e t® ，会是

PCL/HP 激光打印机。这个字符串在设备驱动程序之间是相互不同的。

dmSpecVersion

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

dmDriverVersion

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

dmSize

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

dmDriverExtra

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

dmFields

指定了 D E V M O D E 结构的其余成员中哪些已被初始化。第 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 × 11 英寸MPAPER_LEGAL Legal， 8 1/2 × 14 英寸DMPAPER_A4 A4 letter， 210 × 297 毫米DMPAPER_CSHEET C lette r， 17 × 22 英寸DMPAPER_DSHEET D letter， 22 × 34 英寸DMPAPER_ESHEET E letter， 3 4 × 44 英寸

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

DMPAPER_TABLOID Tabloid ， 1 1 × 17 英寸

DMPAPER_LEDGER Ledger ， 1 7 × 11 英寸

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

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

DMPAPER_A3 A3 Sheet， 2 9 7 × 420 毫米

DMPAPER_A4SMALL A4 Small Sheet ， 2 1 0 × 297 毫米

DMPAPER_A5	A5 Sheet，	1 4 8	×	210	毫米
DMPAPER_B4	B4 Sheet，	2 5 0	×	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 英寸

D M P A P E R _ N O T E N o t e , 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 ， 1 1 0 × 220 毫米

DMPAPER_ENV_C5	C5 EnVelope ，	1 6 2	×	229	毫米
DMPAPER_ENV_C3	C3 EnVelope ，	3 2 4	×	458	毫米
DMPAPER_ENV_C4	C4 EnVelope ，	2 2 9	×	324	毫米

DMPAPER_ENV_C6 C6 EnVelope ， 1 1 4 × 162 毫米

DMPAPER_ENV_C65 C65 EnVelope ， 1 1 4 × 229 毫米

DMPAPER_ENV_B4	B4 EnVelope ，	2 5 0	×	353	毫米
DMPAPER_ENV_B5	B5 EnVelope ，	1 7 6	×	250	毫米
DMPAPER_ENV_B6	B6 EnVelope ，	1 7 6	×	125	毫米

DMPAPER_ENV_ITALY Italy EnVelope ， 1 1 0 × 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 英寸

D M P A P E R _ F A N F O L D _ U S U S S td F a n fo ld , 1 4 7 /8 × 11 英寸

D M P A P E R _ F A N F O L D _ S T D _ G E R M A N G e rm a n S td F a n fo ld , 8 1 /2 × 12 英寸 D M P A P E R _ F A N F O L D _ L G L _ G E R M A N G e rm a n L e g a l F a n fo ld , 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 字体替换设备字体。这是 P o st S c

r i p t®

打印机的缺省动作。

dmCollate

指定在打印多份拷贝的时候是否使用校对。使用 DMCOLLATE_FALSE

后能够得到更快更有效的输出，因为不管要打印多少份拷贝，只向打印机传送一次数据。打印机仅被通知再打印一页。这个成员可以是下列值之一：

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

dmFormName

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

dmUnusedPadding

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

dmBitsPerPel

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

4 位， 256 色使用 8 位，而 65536 色使用 16 位。

dmPelsWidth

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

dmPelsHeight

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

dmDisplayFlags

指定了设备的显示模式。下面是有效的标志：

DM_GRAYSCALE 指定显示使用了无颜色设备。如果没有设

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

标志，就假定非隔行模式。

dmDisplayFrequency

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

注释

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

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

DEVNAMES 结构

DEVNAMES 结构具有如下形式：

typedef struct tagDEVNAMES { /* dvnm */ W O R D w D riverOffset;

W O R D wDeviceOffset;

W O R D wOutputOffset; W O R D wDefault;

/* wDefault 后面是驱动程序，设备和端口名字符串 */

} DEVNAMES;

DEVNAMES 结构中包含的字符串指定了打印机的驱动程序，设备和输出端口的名字。 PrintDlg 函数使用这些字符串来初始化系统定义的 Print 对话框中的成员。当用户关闭对话框时，将在这个结构中返回有关选中的打印机的信息。

成员

wDriverOffset

（输入 /输出）指定了一个以 null 结尾的字符串的偏移，其中包含了设备驱动程序的文件名（没有扩展名）。对于输入，这个字符串将被用于确定要显示在对话框中的打印机。

wDeviceOffset

（输入 /输出）指定了以 null 结尾的字符串（包括 null 在内，最多有 32 个字节），其中包含了设备的名字。这个字符串必须与 D E V M O D E 结构中的 dmDeviceName 成员相同。

wOutputOffset

（输入 /输出）指定了以 null 结尾的字符串，其中包含了物理输出设备（输出端口）的 DOS 设备名。这个字符串必须与 DEVMODE 结构中的

dmDeviceName 成员相同。

wDefault

指定 DEVNAMES 结构中包含的字符串是否表示了缺省打印机。这个字符串被用来检验自最近一次打印操作以来，缺省打印机是否发生变化。对于输入操作，如果设置了 DN_DEFAULTPRN 标志， DEVNAMES 结构中的其它值将被检验，与当前的缺省打印机作比较。如果有字符串不匹配，就会显示一个警告信息，通知用户可能需要重新格式化文档。对于输出操作，只有当显示了 Print Setup 对话框并且用户选择了 O K 按钮时， wDefault 成员才会发生改变。如果选择了缺省的打印机，就会设置DN_DEFAULTPRN 标志。如果选择了一个其它打印机，则不会设置这个标志。这个成员中其它所有的位都是保留的，被 Print 对话框过程内部使用。

请参阅 CPrintDialog::CreatePrinterDC

DRAW ITEMSTRUCT 结构

DRAWITEMSTRUCT 结构具有如下形式：

typedef struct tagDRAWITEMSTRUCT { UINT CtlType;

UINT CtlID;

UINT itemID;

UINT itemAction;

UINT itemState; HWND hwndItem; HDC hDC;

RECT rcItem;

DWORD itemData;

} DRAWITEMSTRUCT;

DRAWITEMSTRUCT 结构提供了拥有者窗口在决定如何画出自画控件或菜单项时必须得到的信息。自画控件或菜单项的拥有者窗口在 WM_DRAWITEM 消息的 lParam 参数中接收到一个指向这个结构的指针。

成员

CtlType

控件类型。控件类型的取值如下：

ODT_BUTTON 自画按钮
ODT_COMBOBOX 自画组合框
ODT_LISTBOX 自画列表框
ODT_MENU 自画菜单
ODT_LISTVIEW 列表视控件

CtlID itemID

ODT_STATIC 自画 Static 控件
ODT_TAB Tab 控件

组合框，列表框或按钮的控制 ID 。对菜单不使用这个成员。

菜单的菜单项 ID 或是组合框或列表框中的项的索引。对于空的列表框或组合框，这个成员是一个负值，这允许应用程序只在 rcItem 成员指定的位置画出焦点矩形，既使控件中没有项。这样用户就可以知道列表框或组合框是否具有输入焦点。 itemAction 成员中位的设置决定了该矩形是否应当画得就象列表框或组合框拥有输入焦点那样。

itemAction

定义了要求的绘图动作。它可以是下面位中的一个或多个：

ODA_DRAWENTIRE 当需要画出整个控件时设置该位。
ODA_FOCUS 当控件获得或失去输入焦点时设置该位。如

果要确定控件是否拥有输入焦点，应该检查 itemState 成员。
ODA_SELECT 当选择项发生变化时设置该位。如果要确定

新的选

择状态，应该检查 itemState 成员。

itemState

指定了完成当前绘图动作后项的可视状态。如果要使菜单项无效，则会设置 ODS_GRAYED 标志。状态标志如下：

ODS_CHECKED 如果要标记菜单项则设置该位。仅对菜单

使用。
ODS_DISABLED 如果要把该项画成禁止状态则设置该位。
ODS_FOCUS 如果该项拥有输入焦点则设置该位。
ODS_GRAYED 如果要使该项变灰则设置该位。仅对菜单使

用。
ODS_SELECTED 如果该项被选中则设置该位。
ODS_COMBOBOXEDIT 绘图发生在自画组合框控件的选择区

域（编辑控件）。
ODS_DEFAULT 该项为缺省项。

hwndItem

指定了组合框，列表框和按钮控件的窗口句柄。指定了包含菜单项的菜单的句柄（ HMENU ）。

hDC rcItem

标识了一个设备环境。在控件上进行绘图操作时必须使用这个设备环境。

hDC 成员指定的设备环境中的矩形，定义了将要画出的控件的边界。W indows 自动将画出的任何东西裁剪在组合框，列表框和按钮的设备环境之内，但是它不裁剪菜单项。在画出菜单项的时候，拥有者不能在 rcItem 成员所定义的矩形之外绘图。

itemData

对于组合框或列表框，这个成员包含了下面的函数传递给列表框的值：

CComboBox::AddString
CComboBox::InsertString
CListBox::AddString
CListBox::InsertString

对于菜单，这个成员包含了下面的函数传递给菜单的值：

CMenu::AppendMenu
CMenu::InsertMenu
CMenu::ModifyMenu

请参阅 CWnd::OnDrawItem

EXTENSION_CONTROL_BLOCK 结构

EXTENSION_CONTROL_BLOCK 结构具有如下形式：

typedef struct _EXTENSION_CONTROL_BLOCK {

DWORD	cbSize;	//IN
DWORD	dwVersion	//IN
HCONN	ConnID;	//IN
DWORD	dwHttpStatusCode;	//OUT
CHAR	lpszLogData[HSE_LOG_BUFFER_LEN];	//OUT
LPSTR	lpszMethod;	//IN

LPSTR	lpszQueryString;	//IN
LPSTR	lpszPathInfo;	//IN
LPSTR	lpszPathTranslated;	//IN
DWORD	cbTotalBytes;	//IN
DWORD	cbAvailable;	//IN
LPBYTE	lpbData;	//IN
LPSTR	lpszContentType;	//IN

BOOL ( W INAPI * GetServerVariable ) ( HCONN hConn,

LPSTR lpszVariableName,

LPVOID lpvBuffer, LPDWORD lpdwSize );

BOOL ( W INAPI * WriteClient )

( HCONN ConnID,

LPVOID Buffer, LPDWORD lpdwBytes, DWORD dwReserved );

BOOL ( W INAPI * ReadClient )

( HCONN ConnID,

LPVOID lpvBuffer, LPDWORD lpdwSize );

BOOL ( W INAPI * ServerSupportFunction ) ( HCONN hConn,

DWORD dwHSERRequest, LPVOID lpvBuffer, LPDWORD lpdwSize, LPDWORD lpdwDataType );

} EXTENSION_CONTROL_BLOCK, *LPEXTENSION_CONTROL_BLOCK;

服务器通过 E XTENSION_CONTROL_BLOCK .与 ISA 通讯。

上面对 IN 和 O U T 的引用指明该成员是适用于发送到扩展的消息（ IN ）还是来自扩展的消息（ O U T ）。

成员

EXTENSION_CONTROL_BLOCK 结构包括如下的域：

cbSize

结构的大小。

dwVersion

HTTP_FILTER_REVISION 的版本信息。 H IW O R D 中包含了主版本号，

LOWORD 中包含了次版本号。

ConnID

由 HTTP 服务器分配的唯一数字。它不能被修改。

dwHttpStatusCode

当完成请求时当前事务的状态。可能是下列值之一：

HTTP_STATUS_BAD_REQUEST
HTTP_STATUS_AUTH_REQUIRED
HTTP_STATUS_FORBIDDEN
HTTP_STATUS_NOT_FOUND
HTTP_STATUS_SERVER_ERROR
HTTP_STATUS_NOT_IMPLEMENTED

lpszLogData

大小为 HSE_LOG_BUFFER_LEN 的缓冲区。包含了当前事务的与 ISA 相关的以 null 结尾的登记信息字符串，这个登记信息将被输入到 HTTP 服务器日志。出于管理的目的，为 HTTP 服务器和 ISA 事务维护一个日志文件会非常有用。

lpsz M ethod

生成请求的方法。与 CGI 变量 REQUEST_METHOD 等价。

lpszQueryString

包含查询信息的以 null 结尾的字符串。与 CGI 变量 QUERY_STRING 等价。

lpszPathInfo

以 null 结尾的字符串，包含了客户给出的附加路径信息。与 CGI 变量

PATH_INFO 等价。

lpszPathTranslated

以 null 结尾的字符串，包含了转换路径。与 CGI 变量

PATH_TRANSLATED 等价。

cbTotalBytes

要从客户端接收的字节总数。与 CGI 变量 CONTENT_LENGTH 等价。如果这个值为 0xffffffff，则有 4G 或更多的数据。在这种情况下，必须调用 C H ttpServerContext:: ReadClient 直到没有更多的数据。

cbAvailable

lpbData 所指向的缓冲区的可能容量。如果 cbTotalBytes 与 cbAvailable 相同，变量 lpbData 指向的缓冲区将包含了客户发出的所有数据。否则cbTotalBytes 将包含接收到的数据的总字节数。 ISA 将需要适用回调函数C H ttpServerContext::ReadClient 来读出数据的剩余部分（从偏移为cbAvailable 的位置开始）。

lpbData

指向一个大小为 cbAvailable 的缓冲区，其中包含了客户发出的数据。

lpszContentType

以 null 结尾的字符串，包含了客户发出数据的内容的类型。与 CGI 变量

CONTENT_TYPE 等价。

GetServerVariable

这个函数将与 HTTP 连接或服务器本身有关的信息（包括 CGI 变量）拷贝到一个缓冲区中。 GetServerVariable 接收如下的参数：

hConn 连接的句柄。
lpszVariableName 以 null 结尾的字符串，指明被要求的是

哪个变量。变量的名字为：

变量名描述

ALL_HTTP 所有还没有被解析为一个上面的变量之一的HTTP 头。这些变量的形式为： HTTP_< 起始域名 >

AUTH_PASS 当客户提供密码时，这将获得与REMOTE_USER 对应的密码。它是一个以 null 结尾的字符串

AUTH_TYPE 包含了使用的鉴定的类型。例如，如果使用了 Basic 鉴定，该字符串为 “ Basic ” 。对于W indowsNTChallenge-response ，这个字符串为 “ NTLM ” 。其它鉴定模式将具有别的字符串。因为可以在 Internet 服务器中加入新的鉴定类型，所以要列出所以可能的字符串是不现实的。如果该字符串为空，则没有使用鉴定

CONTENT_LENGTH 脚本能够期望从客户接收的字节数

CONTENT_TYPE 在 POST 请求的主体部分提供的有关内容类型

的信息

GATEWAY_INTERFACE 服务器支持的 CGI 规格的修订版。当前的版

本为 CGI/1.1

HTTP_ACCEPT 特殊情形的 HTTP 头。 Accept 的值：连结的

域，通过 “ ， ” 隔开。例如，如果下面的几行代码是 HTTP 头的一部分： accept:*/*;q=0.1

accept:text/html accept:image/jpeg

那么 HTTP_ACCEPT 变量将具有以下值：

*/*;q=0.1,text/html,image/jpeg

PATH_INFO 附加的路径信息，与客户给定的相同。这个构成了 URL 中在脚本名之后，而在查询字符串（如果有）之前的部分

PATH_TRANSLATED 这是 PATH_INFO 的值，但是还把一些虚拟路

径名扩展到了目录信息中。QUERY_STRING 在引用该脚本的 URL 中？后面的信息REMOTE_ADDR 客户的 IP 地址

REMOTE_HOST 客户的主机名字

REMOTE_USER 这里包括了客户提供，经服务器鉴定的用户

名

REQUEST_METHOD HTTP 的请求方法

SCRIPT_NAME 要指向的脚本程序的名字

SERVER_NAME 服务器的主机名（或 IP 地址），与在引用自

己的 URL 中出现的一样

SERVER_PORT 接收到请求的 TCP/IP 端口

SERVER_PROTOCOL 与请求相关的信息获取协议的名字和版本。

通常是 HTTP/1.0

SERVER_SOFTWARE CGI 程序运行的 Web 服务器的名字和版本

lpvBuffer

指向缓冲区的指针，该缓冲区用于接收请求的信息。

LpdwSize

指向一个 D W O R D 值的指针，该值指明了缓冲区可以容纳的字节数。如果成功地结束， DWORD 中包含了传送到缓冲区内的字节数目（包括结束符 null）。

W riteClient

从指定的缓冲区向客户发送信息。 W riteClient 具有如下参数：

ConnID HTTP 服务器分配的唯一的连接数。
Buffer 指向要写入数据的缓冲区的指针。
lpdwBytes 指向要写入的数据的指针。
dwReserved 为将来的用途保留。

ReadClient

将 Web 客户的 HTTP 请求中的信息读入调用者提供的缓冲区。ReadClient

具有如下参数：

ConnID HTTP 服务器分配的唯一的连接数。
lpvBuffer 指向接收要求的信息的缓冲区的指针。
lpdwSize 指向 DWORD 值的指针，该值指明缓冲区能够获

得的字节数。 * lpdwSize 中包含了实际传送到缓冲区的字节数。

ServerSupportFunction

向 ISA 提供一些通用目的函数，例如与 HTTP 服务器实现相关的函数。

ServerSupportFunction 具有如下参数：

hConn 连接句柄。
dwHSERRequest HTTP 服务器扩展值。可能的取值和相关参

数的列表参见 ChttpServerContext::ServerSupportFunction 。
lpvBuffer 与 HSE_REQ_SEND_RESPONSE_HEADER 一起使用的时候

，它指向一个以 null 结尾的字符串（例如， “ 401 Acess Denied ”）。如果这个缓冲区为空，这个函数将发出缺省的响应 “ 200 OK ” 。与HSE_REQ_DONE_WITH_SESSION 一起使用的时候，它指向一个DWORD 值，指明了请求的状态代码。
lpdwSize 与 HSE_REQ_SEND_RESPONSE_HEADER 一起使用的时候

，它指向 ldwDataType 缓冲区的大小。
lpdwDataType 以 nll 为结尾的字符串，指向将与头一起

发送的可选的头或数据。如果为 NULL ，这个头将以一组 “ \r\n ” 结束。

注释

服务器用后缀 .EXE 和 .BAT 将文件标识为 CG I（通用网关接口）可执行程序。另外，服务器能用 DLL 后缀将文件标识为要执行的脚本。

当服务器载入 DLL 时，它在入口点 ChttpServer::GetExtensionVersion 调用 DLL ，以获得 HTTP_FILTER_REVISION 的版本号，以及服务器管理者的简短文本描述。对于每个客户请求，都要调用 ChttpServer::GetExtensionVersion 入口点。

扩展将接收共同需要的信息，如查询字符串，路径信息，方法名和转换路径。

请参阅

ChttpServerContext::ReadClient, ChttpServer::GetExtensionVersion, ChttpServer::HttpExtensionProc

FILETIME 结构

FILETIME 结构具有如下形式：

typedef struct _FILETIME {

DWORD dwLowDateTime; /* low 32 bits */ DWORD dwHighDateTime; /* high 32 bits */

} FILETIME, *PFILETIME, *LPFILETIME;

FILETIME 结构是一个 64 位值，代表了自 1601 年以来经过的 100 纳秒的个数。

成员

dwLowDateTime

指定了文件时间的低 32 位值。

DwHighDateTime

指定了文件时间的高 32 位值。

请参阅 Ctime::Ctime

HSE_VERSION_INFO 结构

HSE_VERSION_INFO 结构具有如下形式：

typedef struct _HSE_VERSION_INFO { DWORD dwExtensionVersion;

CHAR lpszExtensionDesc[HSE_MAX_EXT_DLL_NAME_LEN];

} HSE_VERSION_INFO, *LPHSE_VERSION_INFO;

这个结构是由 ChttpServer::GetExtensionVersion 成员函数的 pVer 参数所指向的。它提供了 ISA 的版本号以及 ISA 的文本描述。

成员

dwExtensionVersion

ISA 的版本号。

LpszExtensionDesc

ISA 的文本描述。缺省的实现提供了文本的位置，应当重定义

ChttpServer::GetExtensi- onVersion 函数以提供你自己的描述。

请参阅 ChttpServer::GetExtensionVersion

HTTP_FILTER_CONTEXT 结构

HTTP_FILTER_CONTEXT 结构具有如下形式：

typedef struct _HTTP_FILTER_CONTEXT

{

DWORD cbSize;	//IN
DWORD Revision;	//IN
PVOID ServerContext;	//IN
DWORD ulReserved;	//IN
BOOL fIsSecurePort;	//IN
PVOID pFilterContext; BOOL (WINAPI * GetServerVariable) struct _HTTP_FILTER_CONTEXT * pfc,	//IN/OUT

LPSTR lpszVariableName,

LPVOID lpvBuffer, LPDWORD lpdwSize

);

BOOL (WINAPI * AddResponseHeaders) struct _HTTP_FILTER_CONTEXT * pfc, LPSTR lpszHeaders,

DWORD dwReserved

);

BOOL (WINAPI * WriteClient)

struct _HTTP_FILTER_CONTEXT * pfc, LPVOID Buffer,

LPDWORD lpdwBytes, DWORD dwReserved

);

VOID * ( W INAPI * AllocMem)

struct _HTTP_FILTER_CONTEXT * pfc, DWORD cbSize,

DWORD dwReserved

);

BOOL (WINAPI * ServerSupportFunction) struct _HTTP_FILTER_CONTEXT * pfc, enum SF_REQ_TYPE sfReq,

PVOID pData,

DWORD ul1,

DWORD ul2

);

} HTTP_FILTER_CONTEXT, *PHTTP_FILTER_CONTEXT;

上面的注释 IN 或 IN/OUT 指明成员是仅用于发送到过滤器的消息（ IN ）还是

用于发送到过滤器和从过滤器发出的消息（ OUT ）。

成员

cbSize

以字节数计的结构大小。

Revision

结构的修正级别，小于或等于 HTTP_FILTER_REVISION 的版本。

ServerContext

为服务器的使用而保留。

U lReserved

为服务器的使用而保留。

FIsSecurePort

如果为 TRUE 表明这一事件通过一个安全端口发生。

PFilterContext

过滤器使用的指针，指向环境信息，过滤器将之与请求相关联。在SF_NOTIFY_END _OF_NET_SESSION 通知中可以安全地释放与请求相关的内存。

GetServerVariable

函数的指针，此函数用于获取服务器和连接的信息。有关细节参见

ChttpServerCon- text::GetServerVariable 。 GetServerVariable 具有以下参数：

pfc 指向传递到 ChttpFilter::HttpFilterProc 的过滤器环境

的指针。
lpszVariableName 要获取的服务器变量。
lpvBuffer 用于存储变量值的缓冲区。
lpdwSize 缓冲区 lpvBuffer 的大小。

AddResponseHeaders

函数的指针，此函数在 HTTP 响应上加上头。有关细节参见ChttpServerContext::Server- SupportFunction 中对于HSE_REQ_SEND_RESPONSE_HEADER 的描述。 AddRespon- seHeaders 具有以下参数：

pfc 指向传送给 ChttpFilter::HttpFilterProc 过滤器环境的

指针。
lpszHeaders 包含要加的头的字符串指针。
dwReserved 留作将来使用。必须为 0 。

W riteClient

函数的指针，此函数将原始数据发回客户。有关细节参见

ChttpFilterContext::Write- Clien t。 W riteClient 具有以下参数：

pfc 传送给 ChttpFilter::HttpFilterProc 的指针。
Buffer 包含发送给客户的数据的缓冲区。
lpdwBytes Buffer 指向的缓冲区大小。
dwReserved 留作将来使用。

A lloc M em

指向用来分配内存的函数的指针。当请求结束时，这个函数分配的内存将被自动释放。 A lloc M em 具有以下参数：

pfc 传递给 ChttpFilter::HttpFilterProc 的指针。
cbSize 要分配的缓冲区的大小。
dwReserved 留作将来使用。

ServerSupportFunction

指向用来扩展 ISAPI 过滤器 API 的指针。下面列出的参数与使用的 ISA

有关：

pfc 指向用来扩展 ISAPI 过滤器 API 的函数的指针。
sfReq 服务器函数通知。可能值如下：

SF_REQ_SEND_RESPONSE_HEADER 发送一个完整的 HTTP 服务器响应头，包括状态，服务器版本，消息时间和 M IM E 版本。服务器扩展会在信息的结尾添加其它信息，比如内容类型，内容长度等等，最后是额外的 ’\r\n ’。

SF_REQ_ADD_HEADERS_ON_DENIAL 如果服务器忽略 HTTP 请求，在服务器错误响应加上特定的头。这允许一个授权的过滤器不过滤任何请求而广播它的服务。通常这个头是遵照自定义鉴定模式的

PData

W W W 鉴定头，但是对头指定的内容并不作任何限制。

SF_REQ_SET_NEXT_READ_SIZE 仅被原始数据过滤器使用，返回 SF_STATUS_ READ_NEX T 。

字符串指针。与 ISA 有关。对 sfReg 的每个值，相应的 pData 值参见注释部分的表格。

U l1, ul2

与 ISA 有关。对 sfReg 的每个值，相应的值参见注释部分的表格。

注释

下面是与 ServerSupportFunction 参数对应的可能值：

sfReq	pData					ul1, ul2
SF_REQ_SEND_RESPONSE_	以零结	尾	的字	符	串，	以零结	尾	的	字	符
HEADER	指向可	选	的状	态	字符	串，指	向	将	被	附
	串（	比	如	“	401	加到头	和	设	置	头
AccessDenied ” ），	的可选数据	。	如
对于缺省的响应 “ 200 OK ” 为 NULL	为 NULL ，以空行结束	头	将

SF_REQ_ADD_HEADERS_ ON_DENIAL

SF_REQ_SET_NEXT_READ_ SIZE

请参阅

以零结尾的字符串，指向一个或多个以 ’\r\n ’ 结尾的头行

续表

下一次要读的字节数

ChttpFilter::HttpFilterProc, ChttpFilter::OnLog, ChttpServerContext, ChttpServerContext::GetServerVariable,ChttpServerContext::ServerSupportFunction, ChttpServerContext::WriteClient

HTTP_FILTER_LOG 结构

The HTTP_FILTER_LOG 结构具有如下形式：

typedef struct _HTTP_FILTER_LOG

{

const CHAR *	pszClientHostName;	//IN/OUT
const CHAR *	pszClientUserName;	//IN/OUT
const CHAR *	pszServerName;	//IN/OUT
const CHAR *	pszOperation;	//IN/OUT

const CHAR *	pszTarget;	//IN/OUT
const CHAR *	pszParameters;	//IN/OUT
DWORD	dwHttpStatus;	//IN/OUT
DWORD	dwWin32Status;	//IN/OUT

} HTTP_FILTER_LOG, *PHTTP_FILTER_LOG;

ChttpFilter::HttpFilterProc 中的 pvNotification 指向这个结构，此时 NotificationType 应该是 SF_NOTIFY_LOG ，指明服务器将把信息记入日志文件。字符串不能改变，但是可以替换指针。如果改变了字符串指针，它们所指向的内存必须保持有效，直到产生下一次通知。

上面注释中的 IN/OUT 指明该成员应用于输入（ IN ）或输出（ O U T ）到过滤器的消息。

成员

pszClientHostName

客户的主机名。

PszClientUserName

客户的用户名。

PszServerName

客户所连接的服务器名。

PszOperation

HTTP 命令。

PszTarget

HTTP 命令的目标。

PszParameters

传递给 HTTP 命令的参数。

DwHttpStatus

HTTP 的返回状态。

DwWin32Status

W in32 错误代码。

请参阅 ChttpFilter::HttpFilterProc, ChttpFilter::OnLog

HTTP_FILTER_PREPROC_HEADERS 结构

The HTTP_FILTER_PREPROC_HEADERS 结构具有如下形式：

typedef struct _HTTP_FILTER_PREPROC_HEADERS

{

BOOL (WINAPI * GetHeader)

struct _HTTP_FILTER_CONTEXT * pfc,

LPSTR lpszName, LPVOID lpvBuffer, LPDWORD lpdwSize

);

BOOL (WINAPI * SetHeader)

struct _HTTP_FILTER_CONTEXT * pfc, LPSTR lpszName,

LPSTR lpszValue

);

BOOL (WINAPI * AddHeader)

struct _HTTP_FILTER_CONTEXT * pfc, LPSTR lpszName,

LPSTR lpszValue

);

DWORD dwReserved;

} HTTP_FILTER_PREPROC_HEADERS,

*PHTTP_FILTER_PREPROC_HEADERS;

ChttpFilter::HttpFilterProc 中的 pvNotification 指向这个结构，此时 NotificationType

应该是 SF_NOTIFY_PREPROC_HEADERS ，指明服务器将要处理客户头。

成员

GetHeader

函数指针，该函数接收指定的头值。头名中必须包括冒号（ “ ： ” ）。可以用特定的值，如 “ method ” ， “ url ” 和 “ version ” 来接收请求行的单独部分。 GetHeader 具有以下参数：

pfc 从传递给 ChttpFilter::HttpFilterProc 的过滤器环境指

针中获得的过滤器环境。
lpszName 要获得的头的名字。
lpvBuffer 指向大小为 lpdwSize 的缓冲区的指针，其中

保存了头的值。
lpdwSize lpvBuffer 指向的缓冲区的大小。

SetHeader

函数指针，该函数用于改变或删除头的值。 SetHeader 具有以下参数：

pfc 从传递给 ChttpFilter::HttpFilterProc 的过滤器环境指

针中获得的过滤器环境。
lpszName 要改变或删除的头的名字。
lpszValue 字符串指针，要把头改变为该指针所指向的

字符串；或者是指向 “ \0 ” 的指针，表明要删除头。

AddHeader

函数指针，该函数用于加入头。 AddHeader 具有如下参数：

pfc 从传递给 ChttpFilter::HttpFilterProc 的过滤器环境指

针中获得的过滤器环境。
lpszName 要改变或删除的头的名字。
lpszValue 字符串指针，要把头改变为该指针所指向的

字符串；或者是指向 “ \0 ” 的指针，表明要删除头。

请参阅 ChttpFilter::HttpFilterProc, ChttpFilter::OnPreprocHeaders

HTTP_FILTER_RAW_DATA 结构

The HTTP_FILTER_RAW_DATA 结构具有如下形式：

typedef struct _HTTP_FILTER_RAW_DATA

{

PVOID DWORD	pvInData; cbInData;	//IN //IN
DWORD	cbInBuffer;	//IN
DWORD	dwReserved;	//IN

DWORD

cbInBuffer;

//IN

DWORD

dwReserved;

//IN

} HTTP_FILTER_RAW_DATA, *PHTTP_FILTER_RAW_DATA;

这个结构被传递给 ChttpFilter::HttpFilterProc 的

SF_NOTIFY_READ_RAW_DATA 和 SF_NOTIFY_SEND_RAW_DATA 通知类

型。

成员

pvInData

指向数据缓冲区的指针（输入或输出）。

CbInData

pvInData 所指向的缓冲区中数据的数量。

CbInBuffer

pvInData 所指向的缓冲区的大小。

DwReserved

为将来的使用保留。

请参阅 ChttpFilter::HttpFilterProc, ChttpFilter::OnReadRawData, ChttpFilter::OnSendRawData

HTTP_FILTER_URL_MAP 结构

The HTTP_FILTER_URL_MAP 结构具有如下形式：

typedef struct _HTTP_FILTER_URL_MAP

{

CHAR * pszPhysicalPath; //IN/OUT DWORD cbPathBuff; //IN

} HTTP_FILTER_URL_MAP, *PHTTP_FILTER_URL_MAP;

ChttpFilter::HttpFilterProc 中的 pvNotification 指向这个结构，此时 NotificationType 应该是 SF_NOTIFY_URL_MA P ，指明服务器将把指定了 URL 映射到实际路径。过滤器可以随时修改实际路径。

上面注释中的 IN 或 IN/OUT 指明该成员是仅适用于发往过滤器的消息（ IN ）还是对发往过滤器和过滤器发出的消息都适用（ IN/OUT ）。

成员

pszURL

将要被映射到实际路径的 URL 。

PszPhysicalPath

保存实际路径的缓冲区指针。

CbPathBuff

pszPhysicalPath 所指向的缓冲区的大小。

请参阅 ChttpFilter::HttpFilterProc, ChttpFilter::OnUrl M ap

HTTP_FILTER_VERSION 结构

HTTP_FILTER_VERSION 结构具有如下形式：

typedef struct _HTTP_FILTER_VERSION

{

DWORD dwServerFilterVersion; //IN

DWORD dwFilterVersion; //OUT

CHAR lpszFilterDesc[SF_MAX_FILTER_DESC_LEN+1]; //OUT DWORD dwFlags; //OUT

} HTTP_FILTER_VERSION, *PHTTP_FILTER_VERSION;

这个结构被服务器传递给应用程序的 ChttpFilter::HttpFilterProc 入口点，用来把任何环境信息与 HTTP 请求关联起来。

上面注释中的 IN 或 O U T 指明该成员是适用于发往过滤器的消息（ IN ）还是过滤器发出的消息（ O U T ）。

成员

dwServerFilterVersion

过滤使用的头的版本。当前头文件的版本为 HTTP_FILTER_REVISION 。

DwFilterVersion

HTTP_FILTER_REVISION 的版本。

LpszFilterDesc

保存简短的字符串的位置，该字符串描述了 ISAPI 过滤器应用程序。

DwFlags

SF_NOTIFY_* 标志的组合，用来指明这个应用程序需要什么事件，过滤器以何种优先级载入。有效标志的列表参见 ChttpFilter::GetFilterVersion 和 ChttpFilter:: H ttpFilterProc 。

请参阅 ChttpFilter::HttpFilterProc, ChttpFilter::GetFilterVersion

LINGER 结构

LINGER 结构具有如下形式：

struct linger {

u_short l_onoff; // option on/off

u_short l_linger; // linger time

};

LINGER 结构被用来操作 CasyncSocket::GetSockOpt 的 SO_LINGER 和

SO_DONTLINGER 选项。

注释

设置了 SO_DONTLINGER 选项可以防止成员函数阻塞。在等待发送还未发送

出去的数据时可以关闭。设置这个选项等价于把 SO_LINGER 的 l_onoff 设为 0 。

请参阅 CasyncSocket::GetSockOpt, CasyncSocket::SetSockOpt

LOGBRUSH 结构

LOGBRUSH 结构具有如下形式：

typedef struct tag LOGBRUSH { /* lb */ UINT lbStyle;

COLORREF lbColor;

LONG lbHatch;

} LOGBRUSH;

LOGBRUSH 结构定义了物理刷子的风格、颜色和模板。它被 W indows 的

CreateBrushIndirect 和 ExtCreatePen 函数使用。

成员

lbStyle

指定了刷子的风格。 LbStyle 成员必须是以下风格之一：

BS_DIBPATTERN 一个代模板的刷子，用设备无关位图（ DIB ）来定义。如果 lbStyle 为 BS_DIBPATTERN ，那么 lbHatch 成员中包含了压缩 DIB 的句柄。
- BS_DIBPATTERNPT 一个代模板的刷子，用设备无关位图
  
  （ DIB ）来定义。如果 lbStyle 为 BS_DIBPATTERN PT ，那么 lbHatch 成员中包含了指向压缩 DIB 的指针。
- BS_HATCHED 阴影刷子。
- BS_HOLLOW 空刷子。
- BS_NULL 与 BS_HOLLOW 相同。
- BS_PATTERN 用内存位图定义的模板刷子。
- BS_SOLID 实心刷子。

LbColor

指定了画出刷子的颜色。如果 lbStyle 为 BS_HOLLOW 或 BS_PATTERN 风格，将会忽略 lbColor 。如果 lbStyle 为 BS_DIBPATTERN 或BS_DIBPATTERNBT ，则 lbColor 的低位字指定了 BITMAPINFO 结构的bmiColors 成员是包含了准确的红、绿、蓝（ RGB ）值还是包含当前使用的逻辑调色板的索引。 LbColor 成员可以取如下值之一：

D IB_PAL_COLORS 颜色表中包含了当前使用的逻辑调色板
中的 16

位索引数组。

D IB_RGB_COLORS 颜色表中包含了准确的 RGB 值。

LbHatch

指定了阴影的风格。其含义依赖于 lbStyle 所定义的刷子风格。如果 lbStyle 为 BS_DIBPATTERN ，则 lbHatch 成员中包含了包装的 DIB 的句柄。如果 lbStyle 为 BS_DIBPATTERNPT ，则 lbHatch 成员中包含了包装的 DIB

的指针。如果 lbStyle 为 BS_HATCHED ，则 lbHatch 成员指定了创建阴影时使用的线条的方向。它可以取下面列出的值：

HS_BDIAGONAL 45 度向上，从左到右的阴影。
HS_CROSS 纵横交叉的阴影。
HS_DIAGCROSS 45 度交叉的阴影。
HS_FDIAGONAL 45 度向下，从左到右的阴影。
HS_HORIZONTAL 水平阴影。
HS_VERTICAL 垂直阴影。

如果 lbStyle 是 BS_PATTERN ，则 lbHatch 为定义了模板的位图句柄。如果 lbStyle

为 BS_SOLID 或 BS_HOLLOW ，则 lbHatch 被忽略。

注释

lbColor 控制着阴影刷子的前景色， CDC::SetBkMode 和 CDC::SetBkColorbm 函数控制着背景色。

请参阅 CDC::GetCharABCWidths

LOGPEN 结构

LOGPEN 结构具有如下形式：

typedef struct tagLOGPEN { /* lgpn */

UINT lopnStyle;

POINT lopnWidth; COLORREF lopnColor;

} LOGPEN;

LOGPEN 结构定义了画笔的风格、宽度和颜色，画笔是用于画出线条和边界的绘图对象。 Cpen::CreatePenIndirect 函数使用 LOGPEN 结构。

成员

lopnStyle

指定了画笔的风格。这个成员可以是以下值之一：

PS_SOLID	创建实心的画笔。
PS_DASH	创建短线画笔。（仅当画笔宽度为	1	时有效）

PS_DOT 创建点线画笔。（仅当画笔宽度为 1 时有效）
PS_DASHDOT 创建点划线画笔。（仅当画笔宽度为 1 时有

效）
PS_DASHDOTDOT 创建短线与两个点相间的画笔。（仅当画

笔宽度为 1 时有效）
PS_NULL 创建空画笔。
PS_INSIDEFRAME 创建一种画笔，在封闭图形的框架内部

画线，这个图形是由那些指定边界矩形的 GDI 输出函数（例如 Ellipse ， Rectangle ， RoundRect ， Pie 以及 C hord 成员函数）生成的。当对那些

不指定边界矩形的 GDI 输出函数（例如 LineTo 成员函数）应用这个风格时，画笔的绘图区域并不被限制在框架内部。

如果画笔具有 PS_INSIDEFRAME 风格，并且其颜色与逻辑颜色表中的颜色不匹配，那么将用抖动色画出该画笔。不能用 PS_SOLID 风格来创建具有抖动色的画笔。当画笔宽度小于或等于 1 时， PS_INSIDEFRAME 风格与 PS_SOLID 风格相同。

当对 Ellipse ， Rectangle 和 RoundRect 以外的函数产生的 GDI 对象使用PS_INSIDEFRAME 风格时，画出的线条可能不会完全位于指定的框架内部。

LopnWidth

指定画笔的宽度，使用逻辑单位。如果 lopnWidth 成员为 0 ，则不论当前的映射模式是什么，画笔在光栅设备上的宽度都是一个象素。

LopnColor

指定画笔的颜色。

注释

lopnWidth 成员中 POINT 结构的 y 值没有被使用。

请参阅 Cpen::CreatePenIndirect

MEASUREITEMSTRUCT 结构

MEASUREITEMSTRUCT 数据结构具有如下形式：

typedef struct tagMEASUREITEMSTRUCT { UINT CtlType;

UINT CtlID;

UINT itemID;

UINT itemWidth;

UINT itemHeight; DWORD itemData

} MEASUREITEMSTRUCT;

MEASUREITEMSTURCT 结构通知 W indows 自画控件或菜单项的尺度。这使得 W indows 能够正确处理控件的用户交互。如果没有正确地填充MEASUREITEMSTRUCT 结构中的成员，可能会导致控件的不正确的操作。

成员

CtlType

包含了控件的类型。控件类型的取值如下：

ODT_COMBOBOX 自画组合框。
ODT_LISTBOX 自画列表框。

CtlID ItemID

ODT_MENU 自画菜单。

包含了组合框、列表框或按钮的控制 ID 。菜单不使用这个成员。

包括了菜单的菜单项 ID 或是可变高度的组合框或列表框中列表框项的

ID 。这个成员不对固定高度的组合框、列表框和按钮使用。

ItemWidth

指定了菜单项的宽度。自画菜单项的所有者必须在它从消息返回之前填充这个成员。

ItemHeight

指定了列表框或菜单中一项的高度。在从消息返回之前，自画组合框、列表框或菜单项的所有者必须填充这个成员。列表框项的最大高度为255 。

ItemData

对于组合框或列表框，这个成员中包含了下列函数传递给列表框的值：

CcomboBox::AddString
CcomboBox::InsertString
ClistBox::AddString
ClistBox::InsertString

对于菜单，这个成员中包含了下列函数传递给菜单的值：

Cmenu::AppendMenu
Cmenu::InsertMenu
Cmenu::ModifyMenu

请参阅 CWnd::OnMeasureItem

M INMAXINFO 结构

M INMAXINFO 结构具有如下形式：

typedef struct tagMINMAXINFO { POINT ptReserved;

POINT ptMaxSize; POINT ptMaxPosition; POINT ptMinTrackSize; POINT ptMaxTrackSize;

} MINMAXINFO;

M INMAXINFO 结构中包含了有关窗口的最大化大小和位置以及最大、最小跟踪大小的信息。

成员

ptReserved

为内部使用保留。

PtMaxSize

指定了窗口的最大化宽度（ point.x ）和最大化高度（ point.y ）。

pt M axPosition

指定了最大化窗口的左边位置（ point.x ）和顶部位置（ point.y ）。

pt M inTrackSize

指定了窗口的最小跟踪宽度（ point.x ）和最小跟踪高度（ point.y ）。

pt M axTrackSize

指定了窗口的最大跟踪宽度（ point.x ）和最大跟踪高度（ point.y ）。

请参阅 CWnd::OnGetMinMaxInfo

MSG 结构

MSG 结构具有如下形式：

typedef struct tagMSG { // msg HWND hwnd;

UINT message;

WPARAM wParam; LPARAM lParam; DWORD time;

POINT pt;

} MSG;

MSG 结构中包含了线程的消息队列中的消息信息。

成员

hwnd

标识了接收的消息的窗口过程所属的窗口的句柄。

M essage

指定了消息号。

WParam

指定了消息的附加信息。具体的含义与 message 成员的值有关。

LParam

指定了消息的附加信息。具体的含义与 message 成员的值有关。

Time

指定了发出消息的时间。

NCCALCSIZE_PARAMS 结构

NCCALCSIZE_PARAMS 结构具有如下形式：

typedef struct tagNCCALCSIZE_PARAMS { RECT rgrc[3]; PWINDOWPOS lppos;

} NCCALCSIZE_PARAMS;

NCCALCSIZE_PARAMS 结构中包含了一些信息，应用程序在处理WM_NCCALCSIZE 消息的时候用它来计算窗口客户区的大小，位置和有效内容。

成员

rgrc

指定了一个矩形数组。第一个矩形包含了窗口被移动或改变大小之后的新坐标。第二个矩形包含了窗口被移动或改变大小之前的坐标。第三个矩形包含了在被移动或改变大小之前窗口客户区的坐标。如果该窗口是一个子窗口，那么这些坐标是相对于父窗口的客户区的。如果该窗口是

Lppos

指向 W INDOWPOS 结构，其中包含了引起窗口移动或改变大小的操作所指定的大小或位置值。

请参阅 CWnd::OnNcCalcSize

PAINTSTRUCT 结构

PAINTSTRUCT 结构具有如下形式：

typedef struct tagPAINTSTRUCT { HDC hdc;

BOOL fErase;

RECT rcPaint;

BOOL fRestore;

BOOL fIncUpdate;

BYTE rgbReserved[16];

} PAINTSTRUCT;

PAINTSTRUCT 结构中包含了被用于画出窗口客户区的信息。

成员

hdc FErase

标识了用于绘图的显示环境。

指定是否要重画背景。如果应用程序需要重画背景，则其为非零值。如果创建 W indows 的窗口类时没有使用背景刷子（参见 W in32 SDK 文档中 WNDCLASS 结构的 hbrBackground 成员的描述），那么应由应用程序负责画出背景。

RcPaint

指定了要重画的矩形区域的左上角和右下角。

FRestore

保留成员。它被 W indows 内部使用。

FIncUpdate

保留成员。它被 W indows 内部使用。

RgbReserved[16]

保留成员。 W indows 内部使用的保留内存块。

请参阅 CpaintDC::m_ps

POINT 结构

POINT 数据结构具有如下形式：

typedef struct tagPOINT {

LONG x;

LONG y;

} POINT;

POINT 结构定义一个点的 x 和 y 坐标。

成员

指定了点的 x 坐标。

指定了点的 y 坐标。

请参阅 Cpoint

RECT 结构

RECT 数据结构具有如下形式：

typedef struct tagRECT { LONG left;

LONG top;

LONG right;

LONG bottom;

} RECT;

RECT 结构定义了矩形的左上角坐标和右下角坐标。

成员

left Top Right

指定了矩形的左上角的 x 坐标。指定了矩形的左上角的 y 坐标。

指定了矩形的右下角的 x 坐标。

Bottom

指定了矩形的右下角的 y 坐标。

请参阅 Crect

RGNDATA 结构具有如下形式：

typedef struct _RGNDATA { /* rgnd */ RGNDATAHEADER rdh;

char Buffer[1];

} RGNDATA;

RGNDATA 结构中包含了一个头和一个矩形数组，组成了一个区域。这些矩形从左到右、从上到下排列，没有重叠。

成员

rdh

Buffer

指定了一个 RGNDATAHEADER 结构。（有关这个结构的更多信息参见W in32 SDK 文档）这个结构的成员指定了区域的类型（是矩形还是不规则多边形），组成区域的矩形数目，包含矩形结构的缓冲区大小，等等。

指定了任意大小的缓冲区，其中包含了组成区域的 RECT 结构。

请参阅 CRgn::CreateFromData, CRgn::GetRegionData

SIZE 结构具有如下形式：

typedef struct tagSIZE { int cx;

int cy;

} SIZE;

SIZE 结构指定了矩形的宽度和高度。

成员

指定了函数返回时的 x 范围。

指定了函数返回时的 y 范围。

注释

这个结构中保存的矩形尺度信息可以作为视口的范围，窗口范围，文本范围，位图尺度或者是一些扩展函数使用的 aspect-ratio 过滤器。

请参阅 Csize

SOCKADDR 结构

SOCKADDR 结构具有如下形式：

struct sockaddr {

unsigned short sa_family; char sa_data[14];

};

SOCKADDR 结构被用来保存参与 W indows Sockets 通讯的机器的 Internet 协议

（ IP ）地址。

成员

sa_family

Socket 地址家族。

Sa_data

所有不同的 socket 地址结构的最大大小。

M icrosoft TCP/IP Sockets 开发包只支持 Internet 地址域。为了填充地址的每个部分，应当使用 SOCKADDR_IN 结构，它是这个地址格式所特有的。SOCKADDR 和 SOCKADDR_IN 数据结构的大小相同。你可以在这两种数据结构之间转换。更多的信息参见 W in32 SDK 文档中的 “ W indows Sockets 编程考虑 ” 。

请参阅 SOCKADDR_IN, CasyncSocket::Create, Csocket::Create

SOCKADDR_IN 结构

SOCKADDR_IN 结构具有如下形式：

struct sockaddr_in{

short sin_family; unsigned short sin_port; struct in_addr sin_addr; char sin_zero[8];

};

在 Internet 地址家族中， SOCKADDR_IN 结构被 W indows Sockets 用来指定要连接的本地或远程结束点地址。这是一种与 Internet 地址家族有关的SOCKADDR 结构的形式，并且它可以被强制转换为 SOCKADDR 。

sin_family

地址家族（必须是 AF_INET ）。

Sin_port

IP 端口。

Sin_addr

IP 地址。

Sin_zero

用于将该结构对齐到与 SOCKADDR 相同的大小。

注释

这个结构中的 IP 地址部分属于 IN_ADDR 类型。在 W indows Sockets 头文件

W INSOCK.H 中， IN_ADDR 是按照下面的方式定义的：

struct in_addr { union {

struct{

unsigned char s_b1,

s_b2, s_b3,

s_b4;

} S_un_b; struct {

unsigned short s_w1,

s_w2;

} S_un;

};

} S_un_w;

unsigned long S_addr;

更多的信息参见 W in32 SDK 文档中的 “ W indows Sockets 编程考虑 ” 。

请参阅 SOCKADDR

SYSTEMTIME 结构

SYSTEMTIME 结构具有如下形式：

typedef struct _SYSTEMTIME { WORD wYear;

WORD wMonth; WORD wDayOfWeek; WORD wDay;

WORD wHour;

WORD wMinute;

WORD wSecond;

WORD wMilliseconds;

} SYSTEMTIME;

SYSTEMTIME 结构代表了日期和时间，对于月、日、年、周、时、分、秒和毫秒分别使用了不同的成员。

成员

wYear

当前的年。

WMonth

当前的月，一月为 1 。

WDayOfWeek

当前的周日，星期日为 0 ，星期一为 1 ，依次类推。

WDay

当前的日期。

WHour

当前的小时。

W M inute

当前的分钟数。

WSecond

当前的秒数。

W M illiseconds

当前的毫秒数。

请参阅 Ctime::Ctime

TEXTMETRIC 结构

TEXTMETRIC 结构具有如下形式：

typedef struct tagTEXTMETRIC { /* tm */ int tmHeight;

int tmAscent;

int tmDescent;

int tmInternalLeading; int tmExternalLeading; int tmAveCharWidth;

int tmMaxCharWidth;

int tmWeight; BYTE tmItalic; BYTE tmUnderlined; BYTE tmStruckOut; BYTE tmFirstChar; BYTE tmLastChar;

BYTE tmDefaultChar; BYTE tmBreakChar; BYTE tmPitchAndFamily; BYTE tmCharSet;

int tmOverhang;

int tmDigitizedAspectX; int tmDigitizedAspectY;

} TEXTMETRIC;

TEXTMETRIC 结构中包含了有关物理字体的基本信息。所有的大小都是用逻辑单位给出的，这意味着，它们依赖于显示环境的当前映射模式。

有关这个结构的更完整的信息参见 W in32 SDK 文档中的 TEXTMETRIC 。

请参阅 CDC::GetTextMetrics, TEXTMETRIC

W INDOWPLACEMENT 结构

W INDOWPLACEMENT 数据结构具有如下形式：

typedef struct tagWINDOWPLACEMENT { /* wndpl */ UINT length;

UINT flags;

UINT showCmd; POINT ptMinPosition; POINT ptMaxPosition; RECT rcNormalPosition;

} WINDOWPLACEMENT;

W INDOWPLACEMENT 结构中包含了有关窗口在屏幕上位置的信息。

成员

length Flags

指定了结构的长度，以字节为单位。

指定了控制最小化窗口的位置的标志以及复原窗口的方法。这个成员可以是下面列出的标志之一，或都是：

WPF_SETMINPOSITION 表明可以指定最小化窗口的 x 和 y 坐标

。如果是在 pt M inPosition 成员中设置坐标，则必须指定这个标志。
WPF_RESTORETOMAXIMIZED 表明复原后的窗口将会被最大化，

而不管它在最小化之前是否是最大化的。这个设置仅在下一次复原窗口时有效。它不改变缺省的复原操作。这个标志仅当 showCmd 成员中指定了 SW_SHOWMINIMIZED 时才有效。

ShowCmd

指定了窗口的当前显示状态。这个成员可以是下列值之一：

SW_HIDE 隐藏窗口，使其它窗口变为激活的。
SW_MINIMIZE 最小化指定的窗口，并激活系统列表中的

顶层窗口。
SW_RESTORE 激活并显示窗口。如果窗口是最小化或最大

化的，

W indows 将把它恢复到原来的大小和位置（与 SW_SHOWNORMAL

相同）。

SW_SHOW 激活窗口并按照当前的位置和大小显示窗口。
SW_SHOWMAXIMIZED 激活窗口并将其显示为最大化的。
SW_SHOWMINIMIZED 激活窗口并将其显示为图标。
SW_SHOWMINNOACTIVE 将窗口显示为图标。当前激活的窗口

仍保持激活状态。
SW_SHOWNA 按当前状态显示窗口。当前激活的窗口仍保

持激活状态。
SW_SHOWNOACTIVATE 按最近的位置和大小显示窗口。当前

激活的窗口仍保持激活状态。
SW_SHOWNORMAL 激活并显示窗口。如果窗口是最小化或最

大化的， W indows 将它恢复到原来的大小和位置（与 SW_RESTORE 相同）。

PtMinPosition

指定了窗口被最小化时左上角的位置。

PtMaxPosition

指定了窗口被最大化时左上角的位置。

RcNormalPosition

指定了窗口处于正常状态（复原）时的坐标。

请参阅 CWnd::SetWindowPlacement

W INDOWPOS 结构

W INDOWPOS 数据结构具有如下形式：

typedef struct tagWINDOWPOS { /* wp */ HWND hwnd;

HWND hwndInsertAfter;

int x;

int y;

int cx;

int cy;

UINT flags;

} WINDOWPOS;

W INDOWPOS 结构包含了有关窗口的大小和位置的信息。

成员

hwnd

标识窗口。

HwndInsertAfter

标识了一个窗口，本窗口将被放在这个窗口的后面。

指定了窗口的左边界的位置。

指定了窗口的右边界的位置。

指定了窗口的宽度，以象素为单位。

Cy Flags

指定了窗口的高度，以象素为单位。

指定了窗口位置的选项。这个成员可以是下列值之一：

SWP_DRAWFRAME 画出窗口的边框（在窗口类的描述中定义

）。窗口接收到一个 WM_NCCALCSIZE 消息。
SWP_FRAMECHANGED 向窗口发送一个 W M _NCCALCSIZE 消息，即

使没有改变窗口的大小。如果没有指定这个标志，仅当窗口的大小发生变化时才发送 W M _NCCALCSIZE 消息。
SWP_HIDEWINDOW 隐藏窗口。
SWP_NOACTIVATE 不激活窗口。
SWP_NOCOPYBITS 废弃客户区的全部内容。如果没有指定

这个标志，将会保存客户区的有效内容并在窗口被改变大小或重定位以后回送到客户区。
SWP_NOMOVE 保留当前位置（忽略 x 和 y 成员）。
SWP_NOOWNERZORDER 不改变所有者窗口在 Z 轴上的顺序。
SWP_NOSIZE 保留当前大小（忽略 cx 和 cy 成员）。
SWP_NOREDRAW 不重画改变的内容。
SWP_NOREPOSITION 与 SWP_NOOWNERZORDER 相同。
SWP_NOSENDCHANGING 防止窗口接收

WM_WINDOWPOSCHANGING 消息。

SWP_NOZORDER 保留当前顺序（忽略 hwndInsertAfter 成员）
SWP_SHOWWINDOW 显示窗口。

请参阅 CWnd::OnWindowPosChanging

WSADATA 结构

WSADATA 结构具有如下形式：

struct WSAData {

WORD wVersion;

WORD wHighVersion;

char szDescription[WSADESCRIPTION_LEN+1];

char szSystemStatus[WSASYSSTATUS_LEN+1]; unsigned short iM axSockets;

unsigned short iM axUdpDg;

char FAR * lpVendorInfo;

};

WSADATA 结构被用来保存全局函数 AfxSocketInit 返回的 W indows Sockets 初始化信息。

成员

wVersion

W indows Sockets DLL 期望调用者使用的 W indows Sockets 规范的版本。

W H ighVersion

这个 DLL 能够支持的 W indows Sockets 规范的最高版本。通常它与

wVersion 相同。

SzDescription

以 null 结尾的 ASCII 字符串，W indows Sockets DLL 将对 W indows Sockets

实现的描述拷贝到这个字符串中，包括制造商标识。文本（最多可以有

256 个字符）可以包含任何字符，但是要注意不能包含控制字符和格式字符，应用程序对其最可能的使用方式是把它（可能被截断）显示在在状态信息中。

SzSystemStatus

以 null 结尾的 ASCII 字符串， W indows Sockets DLL 把有关的状态或配置信息拷贝到该字符串中。 W indows Sockets DLL 应当仅在这些信息对用户或支持人员有用时才使用它们，它不应被作为 szDescription 域的扩展。

IM axSockets

单个进出能够打开的 socket 的最大数目。 W indows Sockets 的实现能提供

一个全局的 socket 池，可以为任何进程分配；或者它也可以为 socket 分配属于进程的资源。这个数字能够很好地反映 W indows Sockets DLL 或网络软件的配置方式。应用程序的编写者可以通过这个数字来粗略地指明 W indows Sockets 的实现方式对应用程序是否有用。例如， X W indows 服务器在第一次启动的时候可能会检查 iMaxSockets 的值：如果这个值小于 8 ，应用程序将显示一条错误信息，指示用户重新配置网络软件（这是一种可能要使用 szSystemStatus 文本的场合）。显然无法保证某个应用程序能够真正分配 iM axSockets 个 socket ，因为可能有其它 W indows Sockets 应用程序正在使用。

IM axUdpDg

W indows Sockets 应用程序能够发送或接收的最大的用户数据包协议

（ UDP ）的数据包大小，以字节为单位。如果实现方式没有限制，那么iMaxUdpDg 为零。在 Berkeley sockets 的许多实现中，对于 UDP 数据包有个固有的限制（在必要时被分解），大小为 8192 字节。W indows Sockets 的实现可以对碎片重组缓冲区的分配作出限制。对于适合的 W indows Sockets 实现， iMaxUdpDg 的最小值为 512 。注意不管 iMaxUdpDg 的值是什么，都不推荐你发回一个比网络的最大传送单元（ MTU ）还大的广播数据包。（ W indows Sockets API 没有提供发现 MTU 的机制，但是它不会小于 512 个字节）

lpVendorInfo

指向销售商的数据结构的指针。这个结构的定义（如果有）超出了 W indows

Sockets 规范的范围。更多的信息“ 参见 W in32 SDK 文档 ”中的“ W indows Sockets 编程考虑 ” 。

注意在 MFC 中， WSADATA 结构是由 AfxSock et Init 函数返回的，你在InitInstance 函数中调用这个函数。如果你需要在以后使用这些信息，你可以获得这个结构并将它保存在程序中。

请参阅 AfxSocketInit

XFORM 结构

XFORM 结构具有如下形式：

typedef struct tagXFORM { /* xfrm */ FLOAT eM11;

FLOAT eM12;

FLOAT eM21;

FLOAT eM22;

FLOAT eDx;

FLOAT eDy;

} XFORM;

注释

XFORM 结构指定了从世界空间到页面空间的转换。 EDx 和 eDy 成员分别指定了水平和垂直转换成分。下面的表格显示了其它成员是如何被使用的，依赖于其它操作：

操作	eM11	eM12	eM21				eM22
旋转	旋转角度的余弦	旋转角度的正弦	旋转角	度	的	反	旋转	角	度
			正弦	的余弦
缩放	水平缩放成分	空	空	垂直缩	放
				成分
修剪	空	水平比例常量	垂直比例常量	空
反射	水平反射成分	空	空	垂直反	射

成分

请参阅 CRgn::CreateFromData

MFC 使用的风格

在多数情况下，下面的主题中描述的风格是在 d wstyle 参数中指定的。进一步的信息参考每种风格的 “ 请参阅 ” 部分中列出的成员函数。

按钮风格

BS_AUTOCHECKBOX 与复选框相同，但是当用户选择复选框

时，检查标记出现在复选框中，而当用户再一次选择复选框时，检查标记就消失。
BS_AUTORADIOBUTTON 与单项按钮相同，但是当用户选择它

的时候，这个按钮自动加亮显示自己并去掉同组中相同风格的其它单项按钮的选择状态。
BS_AUTO3STATE 与三态复选框相同，但是当用户选择该框

时它会改变自己的状态。
BS_CHECKBOX 创建一个小方块，在它的右边显示文本（

除非这个风

格与 BS_LEFTTEXT 风格一起使用）。

BS_DEFPUSHBUTTON 创建一个具有深黑边界的按钮。用户可
以按下

ENTER 键以选择这个按钮。这个风格使用户可以快速地选择最相似的选项

（缺省选项）。

BS_GROUPBOX 创建一个矩形区域，其中的按钮是成组的

。与这种风格相关的任何文本将显示在矩形的左上角。
BS_LEFTTEXT 当与单项按钮风格或复选框风格一起使用

时，文本出现

在单项按钮或复选框的左边。

BS_OWNERDRAW 创建一个自画按钮。当按钮的视觉状态发

生改变时，框架调用 DrawItem 成员函数。当使用 CBitmapB utton 类的时候，必须设置这个风格。
BS_PUSHBUTTON 创建一个按钮，当用户选择该按钮时向所

有者窗口发送一个 W M _COMMAND 消息。
BS_RADIOBUTTON 创建一个小圆形区域，在它的右边显示

文本（除非这个风格与 BS_LEFTTEXT 风格一起使用）。单项按钮通常成组使用但是只能独占选择。
BS_3STATE 与复选框类似，但是这个框不仅可以被选中

，还可以被变灰。变灰状态通常用来标识该复选框已经被禁止。

请参阅 CButton::Create

组合框风格

CBS_AUTOHSCROLL 当用户在行尾输入一个字符时，自动把

编辑控件中的文本向右滚动。如果没有设置该风格，则输入的文本信息只能多到填满矩形边框。
CBS_DROPDOWN 与 CBS_SIMPLE 类似，但是除非用户选择了编

辑控件旁边的图标，否则不会显示列表框。
CBS_DROPDOWNLIST 与 CBS_DROPDOWN 类似，但是编辑控件被

静态文本项代替，其中显示了列表框中的当前选择。
CBS_HASSTRINGS 包含了字符串组成的项的自画组合框。

组合框维护着字符串的内存和指针，因此应用程序可以使用 GetText 成员函数从某个项获得文本。
CBS_OEMCONVERT 在组合框的编辑控件内输入的文本将从

ANSI 字符集转换到 OEM 字符集，然后再回到 ANS I 。当应用程序调用 W indows 的 AnsiToOem 函数把组合框中的一个 ANSI 字符串转换到 OEM 字符时，这能确保进行了合适的字符转换。这个风格对那些包含了文件名的组合框最有用，仅适用于用 CBS_SIMPLE 或 CBS_DROPDOWN 风格创建的组合框。
CBS_OWNERDRAWFIXED 列表框的拥有者负责画出其内容，列

表框中所有项的高度是一样的。
CBS_OWNERDRAWVARIABLE 列表框的拥有者负责画出其内容，

列表框中各项的高度是不一致的。
CBS_SIMPLE 任何时候都显示列表框。列表框的当前选择

显示在编辑控

件中。

CBS_SORT 自动排列输入到列表框的字符串。
CBS_DISABLENOSCROLL 当列表框没有足够的项以供滚动时，

列表框将显示一个被禁止的垂直滚动条。如果没有这种风格，当列表框不包含足够的项时，这个滚动条将会被隐藏。
CBS_NOINTEGRALHEIGHT 指明组合框的大小就是应用程序在

创建该组合框时指定的大小。通常， W indows 会调整一些组合框的大小，使得组合框不需要显示部分项。

请参阅 CComboBox::Create

编辑风格

ES_AUTOHSCROLL 当用户在行尾输入字符时，自动将文本向
右滚动 10

个字符。当用户按下 ENTER 键时，控件将文本滚动回起始位置。

ES_AUTOVSCROLL 当用户在最后一行输入 ENTER 时，自动将

文本向上滚动一页。
ES_CENTER 在单行或多行编辑控件中将文本对中。
ES_LEFT 在单行或多行编辑控件中将文本靠左对齐。
ES_LOWERCASE 将用户输入到编辑控件的字符全部转换为

小写。
ES_MULTILINE 指明了一个多行编辑控件（缺省的是单行

的）。如果指定了 ES_AUTOVSCROLL 风格，编辑控件将显示尽可能多的文本，并且当用户按下 ENTER 键时会自动地垂直滚动文本。如果没有指定ES _ AUTOVSCROLL 风格，则编辑控件将显示尽可能多的行，如果在按下ENTER 键却没有更多的行要显示的话，就发出蜂鸣声。如果指定了ES_AUTOHSCROLL 风格，当光标到达控件的右边时，多行编辑控件会自动地水平滚动文本。如果要开始一个新行，用户必须按下 ENTER 键。如果没有指定 ES_AUTOHSCROLL 风格，控件会在有必要时自动将单词折合到下一行的开始。如果按下 ENTER 键，则另起一行。折回单词的位置是由窗口的大小决定的。如果窗口的大小发生改变，折回单词的位置也会反生改变，将会重新显示文本。多行编辑控件可以有滚动条。具有滚动条的编辑控件会处理它自己的滚动条消息。没有滚动条的编辑控件按照前面描

述的方式进行滚动，并且处理父窗口发出的任何滚动消息。

ES_NOHIDESEL 通常，当编辑控件失去输入焦点时，它会

隐藏选择区域，当它获得输入焦点时，它会反转显示选择区域。如果指定了ES_NOHIDESEL 风格则去掉了这个缺省的动作。
ES_OEMCONVERT 输入到编辑控件的文本将被从 ANSI 字符集

转换到OEM 字符集，然后转换回 ANSI 字符集。这使得在应用程序调用 W indows 的 AnsiToOem 函数以把编辑控件中的 ANSI 字符串转换为 OEM 字符时，能够进行正确的字符转换。这个风格对包含文件名的编辑控件最有用。
ES_PASSWORD 在编辑控件中输入字符时，将所有的字符

显示为星号

（ * ）。应用程序可以通过 SetPasswordChar 成员函数来改变显示的字符。

ES_RIGHT 在单行或多行编辑控件中将文本靠右对齐。
ES_UPPERCASE 在编辑控件中输入字符时，将所有的字符

转换为大写。
ES_READONLY 禁止用户输入或修改编辑控件中的文本。
ES_WANTRETURN 指定当用户在对话框中的多行编辑控件中

输入文本时，如果按下了 ENTER 键，则插入回车换行符。如果不使用这个风格，按下 ENTER 键的效果与按下对话框的缺省按钮相同。这个风格对单行编辑控件不起作用。

请参阅 CEdit::Create

框架窗口风格

FWS_ADDTOTITLE 指定了要附加到框架窗口标题末尾的信

息。例如， “ M icrosoft Draw - Drawing in Document1 ” 。你可以指定显示在 AppWizard 的 Advanced Options 对话框中的字符串。如果你希望关闭这个选项，重载CWnd::PreCreateWindow 消息。
FWS_PREFIXTITLE 在框架窗口的标题中，在应用程序的名

字之前显示文档的名字。例如，“ Document - WordPad ”。你可以指定显示在 AppWizard 的 Advanced Options 对话框中的字符串。如果你希望关闭这个选项，重载CWnd::PreCreateWindow 消息。
FWS_SNAPTOBARS 控制框架窗口的大小，该窗口围绕着一

个控制条，这个控制条是一个浮动窗口，而不是固定在框架窗口中。这个风格调整窗口的大小以使用控制条。

列表框风格

LBS_EXTENDEDSEL 用户可以通过鼠标和 SHIFT 键或者其它特

殊键组合来选取多个项。
LBS_HASSTRINGS 指定自画列表框中包含的项是由字符串

组成的。列表框维护着字符串的内存和指针，应用程序可以使用 GetText 成员函数来获得特定项的文本。
LBS_MULTICOLUMN 指定一个可以水平滚动的多列列表框。

SetColumnWidth 成员函数设置列的宽度。

LBS_MULTIPLESEL 当用户单击或双击字符串时，切换字符

串的选择状态。可以选择任意数目的字符串。
LBS_NOINTEGRALHEIGHT 列表框的大小与应用程序创建它的

时候指定的大小完全相等。通常， W indows 会调整列表框的大小，是列表框不会只显示部分项。
LBS_NOREDRAW 当列表框发生变化时不更新显示。这个风

格可以通过发送 WM_SETREDRAW 消息在任何时间改变。
LBS_NOTIFY 当用户单击或双击字符串时，父窗口接收到

一个输入消息。
LBS_OWNERDRAWFIXED 列表框的所有者负责画出它的内容，

列表框中的各项是等高的。
LBS_OWNERDRAWVARIABLE 列表框的所有者负责画出其内容，

列表框中的各项的高度不相同。
LBS_SORT 列表框中的字符串是按照字母表顺序排列的

。
LBS_STANDARD 列表框中的字符串是按照字母表顺序排序

的，当用户单击或双击字符串时，父窗口接收到一个输入消息。列表框在每条边上都有边界。
LBS_USETABSTOPS 允许列表框在显示字符串的时候识别并

扩展制表字符。缺省的制表位置是 32 个对话框单位。（对话框单位是水平或垂直距

离。水平对话框单位等于当前对话框基准宽度单位的四分之一。对话框基准单位是通过当前系统字体的宽度和高度来计算的。 W indows 的GetDialogBaseUnits 函数返回以象素为单位的当前对话框基准单位。）

LBS_WANTKEYBOARDINPUT 不论什么时候，只要用户在列表框

具有输入焦点的时候按下了键，列表框就接收到 WM_VKEYTOITEM 或W M_CHARTOITEM 消息。这使得应用程序能够对键盘输入进行特别处理。
LBS_DISABLENOSCROLL 当列表框中没有足够多的项，不需要

滚动时，就显示一个被禁止的垂直滚动条。如果不使用这个风格，当列表框不包含足够多的项时，它就隐藏滚动条。

请参阅 CListBox::Create

消息框风格

消息框类型

MB_ABORTRETRYIGNORE 消息框包含三个按钮： Abort ， Retry 和

Ignore 。

MB_OK 消息框包含一个按钮： O K 。
MB_OKCANCEL 消息框包含两个按钮： O K 和 Cancel。
MB_RETRYCANCEL 消息框包含两个按钮： Retry 和 Cancel。
MB_YESNO 消息框包含两个按钮： Yes 和 No 。
MB_YESNOCANCEL 消息框包含三个按钮： Yes ， No 和 C ancel。

消息框模式

MB_APPLMODAL 用户在当前窗口中继续工作之前必须先响

应消息框。但是，用户可以移动到其它应用程序的窗口中并在那些窗口中工作。如果没有指定 MB_SYSTEMMODAL 和 MB_TASKMODA L ，则缺省值为MB_APPLMODA L 。
MB_SYSTEMMODAL 在用户响应消息框之前，所有的应用程

序都被挂起。系统模式消息框被用来向用户通知严重的、潜在的毁灭性错误，需要立即注意，小心对待。
MB_TASKMODAL 与 MB_APPLMODAL 类似，但是在微软基础类应

用程序中没有用处。这个标志是为那些没有窗口句柄的调用应用程序或库保留的。

消息框图标

MB_ICONEXCLAMATION 在消息框中显示感叹号图标。
MB_ICONINFORMATION 在消息框中显示一个圆包围着字母 “

i” 的图标。
MB_ICONQUESTION 在消息框中显示问号图标。
MB_ICONSTOP 在消息框中显示停止标志图标。

消息框缺省按钮

MB_DEFBUTTON1 第一个按钮是缺省按钮。注意，除非指定

了MB_DEFBUTTON2 或 MB_DEFBUTTON3 风格，否则第一个按钮总是缺省按钮。
MB_DEFBUTTON2 第二个按钮是缺省按钮。
MB_DEFBUTTON3 第三个按钮是缺省按钮。

请参阅 AfxMessageBox

滚动条风格

SBS_BOTTOMALIGN 与 SBS_HORZ 风格一起使用。滚动条的底边

与Create 成员函数中指定的矩形的底边对齐。滚动条具有系统滚动条的缺省高度。
SBS_HORZ 指明了一个水平滚动条。如果既没有指

定SBS_BOTTOMALIGN 风格又没有指定 SBS_TOPALIGN 风格，则滚动条具有 Create 成员函数中指定的高度，宽度和位置。
SBS_LEFTALIGN 与 SBS_VERT 风格一起使用。滚动条的左边

与 Create

成员函数中指定的矩形的左边对齐。滚动条具有系统滚动条的缺省宽度。

SBS_RIGHTALIGN 与 SBS_VERT 风格一起使用。滚动条的右边
与 Create

成员函数中指定的矩形的右边对齐。滚动条具有系统滚动条的缺省宽度。

SBS_SIZEBOX 指明了一个尺寸框。如

果SBS_SIZEBOXBOTTOMRIGHTALIGN 风格和SBS_SIZEBOXTOPLEFTALIGN 风格都没有指定，尺寸框具有 Create 成员函数中指定的高度，宽度和位置。
SBS_SIZEBOXBOTTOMRIGHTALIGN 与 SBS_SIZEBOX 风格一起使用。尺

寸框的右下角与 Create 成员函数中指定的矩形的右下角对齐。尺寸框具有系统尺寸框的缺省大小。
SBS_SIZEBOXTOPLEFTALIGN 与 SBS_SIZEBOX 风格一起使用。尺

寸框的左上角与 Create 成员函数中指定的矩形的左上角对齐。尺寸框具有系统尺寸框的缺省大小。
SBS_TOPALIGN 与 SBS_HORZ 风格一起使用。滚动条的顶边与

Create

成员函数中指定的矩形的顶边对齐。滚动条具有系统滚动条的缺省高度。

SBS_VERT 指明了一个垂直滚动条。如果既没有指定
SBS_RIGHTALIGN 风格也没有指定 SBS_LEFTALIGN 风格，滚动条具有 Create 成员函数中指定的高度，宽度和位置。

请参阅 CScrollBar::Create

静态文本风格

SS_BLACKFRAME 指定了一个带边框的方框，用与窗口边框

相同的颜色画出。缺省的颜色是黑色。
SS_BLACKRECT 指定一个矩形，用窗口边框的颜色填充。

缺省颜色是黑色。
SS_CENTER 指定一个简单的矩形，在矩形的中央显示给

定的文本。文本将在显示之前格式化。超出行尾的单词将自动折回到下一行的开始。
SS_GRAYFRAME 指定一个带边框的方框，用屏幕的背景色（

桌面颜色）画出。缺省的颜色是灰色。
SS_GRAYRECT 指定一个矩形，用屏幕的背景色填充。缺

省的颜色是灰色。
SS_ICON 指定了在对话框中显示的图标。给定的文本是

资源文件中定义的图标名（不是文件名）。 nWidth 和 nHeight 参数被忽略，图标自动调整自己的大小。
SS_LEFT 指定一个简单的矩形，在矩形内显示左对齐的

给定文本。文本在显示之前格式化。超出行尾的单词将自动折回到下一行的开始。
SS_LEFTNOWORDWRAP 指定一个简单的矩形，在矩形内显示

左对齐的给定文本。制表符被扩展，但是不会折回单词。超出行尾的单词被裁剪。
SS_NOPREFIX 除非指定了这个风格，否则 W indows 将控制

文本中所有的 “ & ” 字符解释为加速键前缀。在这种情况下， “ & ” 被移去，字符串

中的下一个字符被加上下划线。如果一个包含文本的静态文本控件不需要这个特性，可能需要加入 SS_NOPREFIX 。这个风格可以用于任何静态控件。你可以用位或操作符把 SS_NOPREFIX 与其它风格组合起来。最常使用这个风格的情况是，可能要在对话框的静态控件中显示带有 “ & ” 字符的文件名或其它字符串。

SS_RIGHT 指定一个简单的矩形，在矩形内显示右对齐

的给定文本。文本在显示之前格式化。超出行尾的单词将自动折回到下一行的开始。
SS_SIMPLE 指定一个简单的矩形，在矩形内显示一行左

对齐的文本。文本行不能用任何方法缩短或改变。（控件的父窗口或对话框不能处理WM_CTLCOLOR 消息）
SS_USERITEM 指定一个用户自定义的项。
SS_WHITEFRAME 指定一个带边框的方框，用窗口背景色画

出。缺省值为白色。
SS_WHITERECT 指定一个矩形，用窗口背景色填充。缺省

值为白色。

请参阅 CStatic::Create

窗口风格

WS_BORDER 创建一个有边界的窗口。
WS_CAPTION 创建一个有标题条的窗口（隐含 WS_BORDER 风

格）。不能与 WS_DLGFRAME 风格一起使用。
WS_CHILD 创建一个子窗口。不能与 WS_POPUP 风格一起使

用。
WS_CLIPCHILDREN 当你在父窗口中绘图时，除去子窗口所

占的区域。在创建父窗口的时候使用。
WS_CLIPSIBLINGS 剪裁相关的子窗口，这意味着，当一个

特定的子窗

口接收到重绘消息时， WS_CLIPSIBLINGS 风格将在子窗口要重画的区域中去掉与其它子窗口重叠的部分。（如果没有指定 WS_CLIPSIBLINGS 风格，并且子窗口有重叠，当你在一个子窗口的客户区绘图时，它可能会画在相邻的子窗口的客户区中。）只与 WS_CHILD 风格一起使用。

WS_DISABLED 创建一个初始状态为禁止的窗口。
WS_DLGFRAME 创建一个窗口，具有双重边界，但是没有

标题条。
WS_GROUP 指定一组控件中的第一个，用户可以用箭头

键在这组控件中移动。在第一个控件后面把 WS_GROUP 风格设置为 FALSE 的控件都属于这一组。下一个具有 WS_GROUP 风格的控件将开始下一组（这意味着一个组在下一组的开始处结束）。
WS_HSCROLL 创建一个具有水平滚动条的窗口。
WS_MAXIMIZE 创建一个最大化的窗口。
WS_MAXIMIZEBOX 创建一个具有最大化按钮的窗口。
WS_MINIMIZE 创建一个初始状态为最小化的窗口。仅与

WS_OVERLAPPED 风格一起使用。

WS_MINIMIZEBOX 创建一个具有最小化按钮的窗口。
WS_OVERLAPPED 创建一个重叠窗口。重叠窗口通常具有标

题条和边

界。

WS_OVERLAPPEDWINDOW 创建一个具有 W S_OVERLAPPED ，

WS_CAPTION ，WS_SYSMENU ，WS_THICKFRAM E ，WS_MINIMIZEBOX 和 WS_MAXIMIZEBOX 风格的重叠式窗口。
WS_POPUP 创建一个弹出式窗口，不能与 WS_CHILD 风格一

起使用。
WS_POPUPWINDOW 创建一个具有 WS_BORDER ， WS_POPUP

和WS_SYSMENU 风格的弹出窗口。为了使控制菜单可见，必须与WS_POPUPWINDOW 一起使用 WS_CAPTION 风格。
WS_SYSMENU 创建一个在标题条上具有控制菜单的窗口。

仅对带标题条的窗口使用。
WS_TABSTOP 指定了一些控件中的一个，用户可以通过

TAB 键来移过

它。 TAB 键使用户移动到下一个用 WS_TABSTOP 风格定义的控件。

WS_THICKFRAME 创建一个具有厚边框的窗口，可以通过厚

边框来改变窗口大小。
WS_VISIBLE 创建一个最初可见的窗口。
WS_VSCROLL 创建一个具有垂直滚动条的窗口。

请参阅 CWnd::Create, CWnd::CreateEx

扩展窗口风格

WS_EX_ACCEPTFILES 指明用这个风格创建的窗口能够接受
拖放文

件。

WS_EX_CLIENTEDGE 指明窗口具有 3D 外观，这意味着，边

框具有下沉的边界。
WS_EX_CONTEXTHELP 在窗口的标题条中包含问号。当用户

单击问号

时，鼠标光标的形状变为带指针的问号。如果用户随后单击一个子窗口，子窗口将接收到一个 WM_HELP 消息。

WS_EX_CONTROLPARENT 允许用户用 TAB 键遍历窗口的子窗口

。
WS_EX_DLGMODALFRAME 指明一个具有双重边界的窗口，当

你在dwStyle 参数中指定了 W S_CAPTION 风格标志时，它可以具有标题条（可选）。
WS_EX_LEFT 指定窗口具有左对齐属性。这是缺省值。
WS_EX_LEFTSCROLLBAR 将垂直滚动条放在客户区的左边。
WS_EX_LTRREADING 按照从左到右的方式显示窗口文本。

这是缺省方式。
WS_EX_MDICHILD 创建一个 M D I 子窗口。
WS_EX_NOPARENTNOTIFY 指定用这个风格创建的子窗口在被

创建或销毁的时候将不向父窗口发送 WM_PARENTNOTIFY 消息。

WS_EX_OVERLAPPEDWINDOW WS_EX_WIND -	组	合了 WS_EX_CLIENTEDGE	和
OWEDGE 风格。 WS_EX_PALETTEWINDOW 组	合	了	WS_EX_WINDOWEDGE	和

OWEDGE 风格。

WS_EX_PALETTEWINDOW 组

合

了

WS_EX_WINDOWEDGE

和

WS_EX_TOPMOST 风格。

WS_EX_RIGHT 赋予窗口右对齐属性。这与窗口类有关。
WS_EX_RIGHTSCROLLBAR 将垂直滚动条（如果有）放在客户

区的右边。这是缺省方式。
WS_EX_RTLREADING 按照从右到左的顺序显示窗口文本。
WS_EX_STATICEDGE 创建一个具有三维边界的窗口，用于

不接受用户输入的项。
WS_EX_TOOLWINDOW 创建一个工具窗口，目的是被用作浮

动工具条。工具窗口具有标题条，比通常的标题条要短，窗口的标题是用小字体显示的。工具窗口不出现在任务条或用户按下 ALT+TAB 时出现的窗口中。
WS_EX_TOPMOST 指定用这个风格创建的窗口必须被放在

所有非顶层窗口的上面，即使这个窗口已经不处于激活状态，它还是保留在最上面。应用程序可以用 SetWindowsPos 成员函数来加入或去掉这个属性。
WS_EX_TRANSPARENT 指定了用这个风格创建的窗口是透明

的。这意味着，在这个窗口下面的任何窗口都不会被这个窗口挡住。用这个风格创建的窗口只有当它下面的窗口都更新过以后才接收 WM_PAINT 消息。
WS_EX_WINDOWEDGE 指定了具有凸起边框的窗口。

请参阅 CWnd::CreateEx

MFC 使用的回调函数

在微软基础类型中出现了三个回调函数。下面的主题中描述了传递给CDC::EnumObjects ， CDC::GrayString 和 CDC::SetAbortProc 的回调函数。有关回调函数的一般用法参见这些处于函数的说明部分。注意所有的回调函数在返回 W indows 前都必须捕捉异常，因为异常不能被抛到回调边界之外。有关异常的更多信息参见 “ Visual C++ 程序员指南 ” 中的文章 “ 异常 ” 。

CDC::EnumObjects 的回调函数

int CALLBACK EXPORT ObjectFunc( LPSTR lpszLogObject , LPSTR* lpData );

参数

lpszLogObject

指向一个 LOGPEN 或 LOGBRUSH 数据结构的指针，其中包含了有关对象的逻辑属性的信息。

lpData

指向应用程序提供的传递给 EnumObjects 函数的数据。

返回值

这个回调函数返回一个整数。返回的值是用户定义的。如果回调函数返回 0 ，则 EnumObjects 中止枚举。

说明

ObjectFunc 名为应用程序提供的函数名预留的位置。实际的名字必须要引出。

请参阅 CDC::EnumObjects

CDC::GrayString 的回调函数

BOOL CALLBACK EXPORT OutputFunc( HDC hDC , LPARAM lpData , int

nCount );

返回值

如果成功，回调函数的返回值必须是 TRU E ；否则为 FALSE 。

参数

hDC

标识了位图的内存设备环境，其宽度和高度至少为 GrayString 涉及的

lpData

n W idth 和 nHeigh t 。

指向要显示的字符串。

nCount

指定了要输出的字符个数。

说明

OutputFunc 为应用程序提供的回调函数名预留了位置。回调函数（ OutputFunc）必须从（ 0 ， 0 ）而不是（ x ， y ）开始画出图形。

请参阅 CDC::GrayString

CDC::SetAbortProc 的回调函数

BOOL CALLBACK EXPORT AbortFunc( HDC hP r , int code );

返回值

如果要继续打印任务，则 abort 处理函数的返回值必须为非零值。如果要取消，则返回值为 0 。

参数

hPr code

标识设备环境。

指明是否发生了错误。如果没有发生错误，则为 0 。如果打印管理器已经用完了磁盘空间，并且如果应用程序等待就能获得更多磁盘空间，则返回 SP_OUTOFDISK 。如果 code 为 SP_OUTOFDISK ，应用程序不必放弃打印任务。如果 code 不是 SP_OUTOFDISK ，它必须通过调用 W indows 的 PeekMessage 或 GetMessage 函数服从打印管理器。

说明

AbortFunc 为应用程序提供的函数名预留了位置。实际的名字必须要引出，如

CDC::SetAbortProc 的说明部分所描述的。

请参阅 CDC::SetAbortProc

消息映射

这个部分列出了所有的消息映射宏和所有的 CWnd 消息映射条目及其对应的成

员函数原型。

分类描述

W M _ C O M M A N D 消息处理函数处理用户菜单选择或菜单键产生的

W M _ C O M M A N D 消息

子窗口通知消息处理函数处理子窗口发出的通知消息

W M _ 消息处理函数处理 W M _ 消息，如 WM_PAINT

用户自定义消息处理函数处理用户自定义消息

（本参考中使用的术语和阅读的解释参见 “ 如何使用消息映射交叉参考 ” ）

由于 W indows 是一个面向消息的操作系统，在 W indows 环境下很大一部分编程工作涉及消息处理。每当发生一个事件，如击键或鼠标点击，就会向应用程序发送一个消息，然后由它来处理事件。

微软基础类库提供了为基于消息的编程而优化的编程模式。在这种模式下，“ 消息映射 ” 被用于指明哪个函数将为特定的类处理不同的消息。消息映射包含了一个或多个宏，用以指定哪个函数处理哪个消息。例如，一个包含ON_COMMAND 宏的消息映射看起来可能象这样：

BEGIN_MESSAGE_MAP( CMyDoc, CDocument )

//{{AFX_MSG_MAP( CMyDoc ) ON_COMMAND( ID_MYCMD, OnMyCommand )

// ...其它入口，用于处理另外的消息

//}}AFX_MSG_MAP

END_MESSAGE_MAP( )

ON_COMMAND 宏被用于处理菜单、按钮和加速键产生的命令消息。可以用宏来映射下列消息：

W indows 消息

控件通知
用户自定义消息

命令消息

注册的用户自定义消息
用户界面更新消息

消息范围

命令
更新处理消息
控件通知

尽管消息映射宏很重要，通常你并不需要直接使用它们。这是因为当你用

ClassWizard 把消息处理函数与消息关联在一起的时候，它将会在源文件中自动创建消息映射入口。不论何时你希望编辑或加入消息映射条目，你都可以使用ClassWizard 。

注意 C lassWizard 不支持消息映射范围。你必须自己写入这些消息映射入口。

但是，消息映射是微软基础类库中很重要的一个部分。你必须理解它们的作用，类库也提供了有关文档。

消息映射宏

为了支持消息映射， MFC 提供了下列宏：

消息映射的声明和分界宏

DECLARE_MESSAGE_MAP 声明将在一个类中使用消息映射，把消息

映射到函数（必须用在类声明中） BEGIN_MESSAGE_MAP 开始消息映射的定义（必须用在类实现中） END_MESSAGE_MAP 结束消息映射的定义（必须用在类实现中）

消息映射宏

ON_COMMAND 指明将由哪个函数处理指定的命令消息

ON_CONTROL 指明将由哪个函数处理指定的控件通知消息

ON_MESSAGE 指明将由哪个函数处理用户自定义的消息

ON_OLECMD 指明将由哪个函数处理 DocObject 或其容器发出的菜单命令

ON_REGISTERED_MESSAGE 指明将由哪个函数处理注册的用户自定义消息

ON_REGISTERED_THREAD_ MESSAGE

指明当你拥有一个 C W inThread 类时，将由哪个函数处理注册的用户自定义消息

ON_THREAD_MESSAGE 指明当你拥有一个 C W inThread 类时，将

由哪个函数处理用户自定义消息

ON_UPDATE_COMMAND_UI 指明将由哪个函数处理指定的用户界面

更新命令消息

消息映射范围宏

ON_COMMAND_RANGE 指明将由哪个函数处理该宏的前两个参

数所指定的范围内的命令 ID

ON_UPDATE_COMMAND_UI_ RANGE

指明将由哪个更新处理器处理该宏的前两个参数所指定的范围内的命令 ID

ON_CONTROL_RANGE 指明将由哪个函数处理该宏的第二和第

三个参数所指定的范围内的控制 ID 发出的通知。第一个参数是一个控件通知消息，例如 BN_CLICKED

有关消息映射、消息映射的声明和分界宏以及消息映射宏的更多的信息参见“ 消息处理 ” 和 “ 映射主题 ” 。有关消息映射范围的更多信息参见 “ 消息映射范围的处理函数 ”。有关如何使用 ClassWizard 的更多信息参见“ 使用 ClassWizard ”。这些参考都在 “ Visual C++ 程序员指南 ” 中。

如何使用消息映射交叉参考

在标着 <memberFxn> 的条目中，写入你的 CWnd 派生类的成员函数。可以给你的函数取任意一个你喜欢的名字。其它函数，例如 OnActive，是 CWnd 类的成员函数。如果调用了它们，它们将消息传递给 W indows 的 DefWindowProc 函数。如果要处理 W indows 通知消息，在你自己的类中重载相应的 CWnd 成员函数。你可以在函数中调用基类的被重载的函数，使基类和 W indows 能够回应消息。

在所有的情况下，将函数原型放入 CWnd 派生类的头文件中，并按照下面的方式编写消息映射入口。

使用了下面的术语：

术语	定义
id	任何	用	户	自	定	义	的	菜	单	项	ID

（ W M _ C O M M A N D 消息）或控件（子窗口通知消息） ID

"message" 和 "wNotifyCode" W INDOWS.H 中定义的 W indows 消息 ID n M essageVariable 包含了 W indows 的

RegisterWindowsMessage 函数的返回值的变量的名字。它必须被声明为 NEAR

WM_COMMAND 消息处理函数

映射入口函数原型

ON_COMMAND( <id>,<memberFxn> ) afx_msg void memberFxn( );

子窗口通知消息处理函数

子窗口通知消息有五个部分：

分类描述

通用控件处理函数处理通用控件通知代码

用户按钮处理函数处理用户按钮通知代码

组合框处理函数处理组合框通知代码

续表

编辑控件处理函数处理编辑控件通知代码

列表框处理函数处理列表框通知代码

般控件处理函数

映射入口函数原型

ON_CONTROL( <wNotifyCode>,<id>,

<memberFxn> )

afx_msg void memberFxn( );

用户按钮处理函数

映射入口函数原型

ON_BN_CLICKED(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_BN_DISABLE(<id>, <memberFxn> ) afx_msg void memberFxn( )

ON_BN_DOUBLECLICKED(<id>,

<memberFxn> )

afx_msg void memberFxn( )

ON_BN_HILITE(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_BN_PAINT( <id>, <memberFxn> ) afx_msg void memberFxn( ) ON_BN_UNHILITE(<id>, <memberFxn> ) afx_msg void memberFxn( )

组合框处理函数

映射入口函数原型

ON_CBN_CLOSEUP(<id>, <memberFxn> ) afx_msgvoid memberFxn( ) ON_CBN_DBLCLK(<id>, <memberFxn> ) afx_msgvoid memberFxn( ) ON_CBN_DROPDOWN(<id>, <memberFxn> ) afx_msgvoid memberFxn( )

ON_CBN_EDITCHANGE(<id>,

<memberFxn> ) ON_CBN_EDITUPDATE(<id>,

<memberFxn> )

afx_msgvoid memberFxn( ) afx_msgvoid memberFxn( )

ON_CBN_ERRSPACE(<id>, <memberFxn> ) afx_msgvoid memberFxn( )

ON_CBN_KILLFOCUS(<id>, <memberFxn> ) afx_msgvoid memberFxn( ) ON_CBN_SELCHANGE(<id>, <memberFxn> ) afx_msgvoid memberFxn( )

ON_CBN_SELENDCANCEL(<id>,

<memberFxn> )

afx_msgvoid memberFxn( )

ON_CBN_SELENDOK(<id>, <memberFxn> ) afx_msgvoid memberFxn( ) ON_CBN_SETFOCUS(<id>, <memberFxn> ) afx_msgvoid memberFxn( )

编辑控件处理函数

映射入口函数原型

ON_EN_CHANGE(<id>, <memberFxn> ) afx_msg void memberFxn( )

续表ON_EN_ERRSPACE(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_EN_HSCROLL(<id>, <memberFxn> ) afx_msg void memberFxn( )

ON_EN_KILLFOCUS(<id>,

<memberFxn> )

afx_msg void memberFxn( )

ON_EN_MAXTEXT(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_EN_SETFOCUS(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_EN_UPDATE(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_EN_VSCROLL(<id>, <memberFxn> ) afx_msg void memberFxn( )

列表框控件处理函数

映射入口函数原型

ON_LBN_DBLCLK(<id>, <memberFxn> ) afx_msg void memberFxn( ) ON_LBN_ERRSPACE(<id>, <memberFxn> ) afx_msg void memberFxn( )

ON_LBN_KILLFOCUS(<id>,

<memberFxn> ) ON_LBN_SELCHANGE(<id>,

<memberFxn> )

afx_msg void memberFxn( ) afx_msg void memberFxn( )

ON_LBN_SETFOCUS(<id>, <memberFxn> ) afx_msg void memberFxn( )

W M _ 消息处理函数

主题映射入口

A – C ON_WM_ACTIVATE 到 ON_WM_CTLCOLOR

D – E ON_WM_DEADCHAR 到 ON_WM_ERASEBKGND F – K ON_WM_FONTCHANGE 到 O N_WM_KILLFOCUS L – M ON_WM_LBUTTONDBLCLK 到 ON_WM_MOVING

N – O ON_WM_NCACTIVATE 到 O N _ WM_NCRBUTTONUP P – R ON_WM_PAINT 到 ON_WM_RENDERFORMAT

ON_WM_SETCURSOR 到 ON_WM_SYSKEYUP
– Z ON_WM_TIMECHANGE 到 O N _ W M _ W ININICHANGE

WM_ 消息处理函数： A - C

映射入口	函数原型
ON_WM_ACTIVATE( )	afx_msg void OnActivate( UINT,	CWnd*,
ON_WM_ACTIVATEAPP( )	BOOL ) afx_msg void OnActivateApp(	BOOL,
	HANDLE )

ON_WM_ACTIVATE( )

afx_msg void OnActivate( UINT,

CWnd*,

ON_WM_ACTIVATEAPP( )

BOOL )

afx_msg void OnActivateApp(

BOOL,

HANDLE )

ON_WM_ASKCBFORMATN AME( )

afx_msgvoid OnAskCbFormatName( UINT, LPSTR )

ON_WM_CANCELMODE( ) afx_msg void OnCancelMode( )

ON_WM_CAPTURECHANGED( ) afx_msgvoid

OnCaptureChanged( CWnd* ) ON_WM_CHANGECBCHAIN( ) afx_msgvoid

OnChangeCbChain(HWND, HWND )

ON_WM_CHAR( ) afx_msg void OnChar( UINT, UINT, UINT )

ON_WM_CHARTOITEM( ) afx_msg int OnCharToItem( UINT,

CWnd*, UINT )

ON_WM_CHILDACTIVATE( ) afx_msg void OnChildActivate( ) ON_WM_CLOSE( ) afx_msg void OnClose( ) ON_WM_COMPACTING( ) afx_msgvoid OnCompacting( UINT )

ON_WM_COMPAREITEM( ) afx_msgint OnCompareItem

( LPCOMPAREITEMSTRUCT )

ON_WM_CONTEXTMENU( ) afx_msgvoid OnContextMenu

( CWnd*, CPoint )

ON_WM_COPYDATA( ) afx_msgBOOL OnCopyData (CWnd* Pwnd, COPYDATASTRUCT*

pCopyDataStruct)

ON_WM_CREATE( ) afx_msgint

OnCreate( LPCREATESTRUCT )

ON_WM_CTLCOLOR( ) afx_msg HBRUSH

OnCtlColor( CDC*, CWnd*, UINT )

WM_ 消息处理函数： D - E

映射入口函数原型

ON_WM_DEADCHAR( ) afx_msg void OnDeadChar( UINT,

UINT, UINT )

ON_WM_DELETEITEM( ) afx_msgvoid OnDeleteItem

( LPDELETEITEMSTRUCT )

ON_WM_DESTROY( ) afx_msg void OnDestroy( ) ON_WM_DESTROYCLIPBOARD( ) afx_msg void OnDestroyClipboard( ) ON_WM_DEVICECHANGE( ) afx_msgvoid OnDeviceChange( UINT,

D W O R D )

ON_WM_DEVMODECHANGE( ) afx_msgvoid

OnDevModeChange( LPSTR ) ON_WM_DRAWCLIPBOARD( ) afx_msg void OnDrawClipboard( )

ON_WM_DRAWITEM( ) afx_msgvoid OnDrawItem

( LPDRAWITEMSTRUCT )

ON_WM_DROPFILES( ) afx_msg void OnDropFiles( HDROP ) ON_WM_ENABLE( ) afx_msg void OnEnable( BOOL ) ON_WM_ENDSESSION( ) afx_msg void OnEndSession( BOOL ) ON_WM_ENTERIDLE( ) afx_msg void OnEnterIdle( UINT,

CWnd* )

ON_WM_ERASEBKGND( ) afx_msg BOOL OnEraseBkgnd

( CDC * )

W M _ 消息处理函数： F – K

映射入口函数原型

ON_WM_FONTCHANGE( ) afx_msg void OnFontChange( ) ON_WM_GETDLGCODE( ) afx_msg UINT OnGetDlgCode( ) ON_WM_GETMINMAXINFO( ) afx_msgvoid

OnGetMinMaxInfo( LPPOINT )

ON_WM_HELPINFO( ) afx_msgBOOL OnHelpInfo( HELPINFO* )

ON_WM_HSCROLL( ) afx_msg void OnHScroll( UINT, UINT, CWnd* )

ON_WM_HSCROLLCLIPBOARD() afx_msg void OnHScrollClipboard

(CWnd*,UINT,UINT)

ON_WM_ICONERASEBKGND( ) afx_msg void OnIconEraseBkgnd

( CDC * )

ON_WM_INITMENU( ) afx_msg void OnInitMenu( CMenu

* )

ON_WM_INITMENUPOPUP( ) afx_msgvoid OnInitMenuPopup

( CMenu *, UINT, BOOL )

ON_WM_KEYDOWN( ) afx_msg void OnKeyDown( UINT, UINT, UINT )

ON_WM_KEYUP( ) afx_msg void OnKeyUp( UINT, UINT, UINT )

ON_WM_KILLFOCUS( ) afx_msgvoid OnKillFocus( CWnd* )

W M _ 消息处理函数： L - M

映射入口函数原型

ON_WM_LBUTTONDBLCLK( ) afx_msgvoid OnLButtonDblClk

( UINT, Cpoint )

ON_WM_LBUTTONDOWN( ) afx_msg void OnLButtonDown( UINT,

CPoint )

ON_WM_LBUTTONUP( ) afx_msg void OnLButtonUp( UINT,

CPoint ) ON_WM_MBUTTONDBLCLK( ) afx_msgvoid

OnMButtonDblClk( UINT, CPoint ) ON_WM_MBUTTONDOWN( ) afx_msgvoid OnMButtonDown( UINT,

CPoint )

ON_WM_MBUTTONUP( ) afx_msg void OnMButtonUp( UINT,

CPoint )

ON_WM_MDIACTIVATE( ) afx_msgvoid OnMDIActivate( BOOL,

CWnd*, CWnd* )

ON_WM_MEASUREITEM() afx_msgvoid OnMeasureItem

( LPMEASUREITEMSTRUCT )

ON_WM_MENUCHAR( ) afx_msgLONG OnMenuChar( UINT,

UINT, CMenu * ) ON_WM_MENUSELECT( ) afx_msg void OnMenuSelect( UINT,

UINT, HMENU )

ON_WM_MOUSEACTIVATE( ) afx_msgint OnMouseActivate( CWnd*,

UINT, UINT )

ON_WM_MOUSEMOVE( ) afx_msg void OnMouseMove( UINT,

CPoint )

ON_WM_MOUSEWHEEL( ) afx_msgBOOL OnMouseWheel( UINT,

short, CPoint )

ON_WM_MOVE( ) afx_msg void OnMove( int, int )

ON_WM_MOVING( ) afx_msg void OnMoving( UINT, LPRECT )

W M _ 消息处理函数： N – O

映射入口函数原型

ON_WM_NCACTIVATE( ) afx_msgBOOL OnNcActivate( BOOL )

ON_WM_NCCALCSIZE( ) afx_msgvoid OnNcCalcSize (BOOL, NCCALCSIZE

_PARAMSFAR* )

ON_WM_NCCREATE( ) afx_msgBOOL OnNcCreate ( LPCREATESTRUCT )

ON_WM_NCDESTROY( ) afx_msg void OnNcDestroy( )

ON_WM_NCHITTEST( ) afx_msgUINT OnNcHitTest( Cpoint )

ON_WM_NCLBUTTONDBLCLK( ) afx_msgvoid OnNcLButtonDblClk

( UINT, CPoint )

ON_WM_NCLBUTTONDOWN( ) afx_msgvoid OnNcLButtonDown

( UINT, CPoint )

ON_WM_NCLBUTTONUP( ) afx_msgvoid

OnNcLButtonUp( UINT, CPoint ) ON_WM_NCMBUTTONDBLCLK( ) afx_msgvoid OnNcMButton

DblClk( UINT, Cpoint )

ON_WM_NCMBUTTONDOWN( ) afx_msgvoid OnNcMButtonDown

( UINT, CPoint )

ON_WM_NCMBUTTONUP( ) afx_msgvoid

OnNcMButtonUp( UINT, CPoint )

ON_WM_NCMOUSEMOVE( ) afx_msgvoid OnNcMouseMove

( UINT, CPoint )

ON_WM_NCPAINT( ) afx_msg void OnNcPaint( ) ON_WM_NCRBUTTONDBLCLK( ) afx_msgvoid OnNcRButton

DblClk UINT, CPoint )

ON_WM_NCRBUTTONDOWN( ) afx_msgvoid OnNcRButtonDown

( UINT, Cpoint )

ON_WM_NCRBUTTONUP( ) afx_msgvoid

OnNcRButtonUp( UINT, CPoint )

WM_ 消息： P - R

映射入口函数原型

ON_WM_PAINT( ) afx_msg void OnPaint( )

ON_WM_PAINTCLIPBOARD( ) afx_msgvoid OnPaintClipboard

( CWnd*, HANDLE )

ON_WM_PALETTECHANGED( ) afx_msgvoid

OnPaletteChanged( CWnd* ) ON_WM_PALETTEISCHANGING( ) afx_msgvoid

OnPaletteIsChanging( CWnd* )

ON_WM_PARENTNOTIFY( ) afx_msgvoid OnParentNotify

( UINT, LONG ) ON_WM_QUERYDRAGICON( ) afx_msgHCURSOR

OnQueryDragIcon( ) ON_WM_QUERYENDSESSION( ) afx_msgBOOL

OnQueryEndSession( )

ON_WM_QUERYNEWPALETTE( ) afx_msgBOOL

OnQueryNewPalette( )

ON_WM_QUERYOPEN( ) afx_msg BOOL OnQueryOpen( )

ON_WM_RBUTTONDBLCLK( ) afx_msgvoid OnRButtonDblClk

( UINT, CPoint )

ON_WM_RBUTTONDOWN( ) afx_msgvoid OnRButtonDown

( UINT, CPoint )

ON_WM_RBUTTONUP( ) afx_msg void OnRButtonUp ( UINT, CPoint )

ON_WM_RENDERALLFORMATS( ) afx_msgvoid

OnRenderAllFormats( )

ON_WM_RENDERFORMAT( ) afx_msgvoid OnRenderFormat( UINT )

WM_ 消息： S

映射入口函数原型

ON_WM_SETCURSOR( ) afx_msg BOOL OnSetCursor

( CWnd*, UINT, UINT )

ON_WM_SETFOCUS( ) afx_msg void OnSetFocus( CWnd* )

ON_WM_SHOWWINDOW( ) afx_msg void OnShowWindow

( BOOL, UINT )

ON_WM_SIZE( ) afx_msg void OnSize( UINT, int, int )

ON_WM_SIZECLIPBOARD( ) afx_msgvoid OnSizeClipboard

( CWnd*, HANDLE )

ON_WM_SIZING( ) afx_msg void OnSizing( UINT, LPRECT )

ON_WM_SPOOLERSTATUS( ) afx_msg void OnSpoolerStatus

( UINT, UINT )

ON_WM_STYLECHANGED( ) afx_msg void OnStyleChanged( int,

LPSTYLESTRUCT )

ON_WM_STYLECHANGING( ) afx_msg void OnStyleChanging( int,

LPSTYLESTRUCT )

ON_WM_SYSCHAR( ) afx_msg void OnSysChar( UINT, UINT, UINT )

ON_WM_SYSCOLORCHANGE( ) afx_msg void OnSysColorChange( )

ON_WM_SYSCOMMAND( ) afx_msg void OnSysCommand

( UINT, LONG )

ON_WM_SYSDEADCHAR( ) afx_msg void OnSysDeadChar

( UINT, UINT, UINT )

ON_WM_SYSKEYDOWN( ) afx_msg void OnSysKeyDown

( UINT, UINT, UINT )

ON_WM_SYSKEYUP( ) afx_msg void OnSysKeyUp( UINT,

UINT, UINT )

映射入口	函数原型
ON_WM_TCARD( )	afx_msg	void	OnTCard(	UINT,

DWORD )

ON_WM_TIMECHANGE( ) afx_msg void OnTimeChange( )

ON_WM_TIMER( ) afx_msg void OnTimer( UINT )

ON_WM_VKEYTOITEM( ) afx_msg int OnVKeyToItem ( UINT, CWnd*, UINT )

ON_WM_VSCROLL( ) afx_msg void OnVScroll( UINT, UINT, CWnd* )

ON_WM_VSCROLLCLIPBOARD( ) afx_msgvoid OnVScrollClipboard

( CWnd*, UINT, UINT )

ON_WM_WINDOWPOSCHANGED( ) afx_msgvoid

OnWindowPosChanged

( W INDOWPOS* lpwndpos ) ON_WM_WINDOWPOSCHANGING( ) afx_msgvoid

OnWindowPosChanging

( W INDOWPOS*lpwndpos )

ON_WM_WININICHANGE( ) afx_msgvoid OnWinIniChange( LPSTR )

映射入口函数原型

ON_MESSAGE(<message>, <memberFxn> ) afx_msgLRESULT

memberFxn

( W P A R A M , LPARAM ) ；

ON_REGISTERED_MESSAGE

(<nMessageVariable>, <memberFxn> )

ON_THREAD_MESSAGE( <message>,

<memberFxn> ) ON_REGISTERED_THREAD_MESSAGE

(<nMessageVariable>, <memberFxn> )

afx_msgLRESULT memberFxn

W P A R A M , LPARAM ) ；

afx_msgvoid

memberFxn( UINT, LONG ) afx_msgvoid memberFxn

( UINT, LONG ) ；

旧的 MFC 函数

下面的函数在 MFC 6 .0 中没有实现：

CDatabase::InWaitForDataSource
CDatabase::OnWaitForDataSource
CDatabase::SetSynchronousMode
CRecordset::On W aitForDataSource
CTabCtrl::GetBkColor
CTabCtrl::SetBkColor
CTabCtrl::SetItemExtra
C W inApp::InitApplication
CWnd::GetSuperWndProcAddr

CDatabase::In W a itForDataSource

说明

在 MFC4.2 中， CDatabase::OnWaitForDataSource 已经过时了。现在 MFC ODBC 类只使用同步处理。如果要开始异步操作，你必须直接调用 ODBC API 函数SQLSetConnetOption 。更多的信息参见 ODBC SDK 程序员指南中的 “ 异步执行函数 ” 主题。

说明

在 MFC4.2 中， CDatabase::WaitForDataSource 已经过时了。现在 MFC ODBC 类只使用同步处理。如果要开始异步操作，你必须直接调用 ODBC API 函数SQLSetConnetOption 。更多的信息参见 ODBC SDK 程序员指南中的 “ 异步执行函数 ” 主题。

CDatabase::SetSynchronousMode

说明

在 MFC4.2 中， CDatabase::SetSynchronousMode 已经过时了。现在 MFC ODBC 类只使用同步操作。如果要开始异步操作，你必须直接调用 ODBC API 函数SQLSetConnetOption 。更多的信息参见 ODBC SDK 程序员指南中的 “ 异步执行函数 ” 主题。

注意尽管 SetSynchronousMode 已经过时，但是如果你使用了这个成员函数，你的代码还是能够被编译。SetSynchronousMode 会产生一个 TRACE 消息，不做任何操作。

说明

在 MFC4.2 中，C R ecordset::OnWaitForDataSource 已经过时了。现在 MFC ODBC 类只使用同步操作。如果要开始异步操作，你必须直接调用 ODBC API 函数SQLSetConnetOption 。更多的信息参见 ODBC SDK 程序员指南中的 “ 异步执行函数 ” 主题。

CTabCtrl::GetBkColor

说明

GetBkColor 和 SetBkColor 成员函数对 CTabCtrl 类不再有效。这些成员函数在MFC 中没有实现，因为它们依赖的 W indows95 的 TCM_SETCOLOR 消息没有实现。

请参阅 W in32 程序员参考中的 COLORREF

说明

SetBkColor 和 GetBkColor 成员函数对 CTabCtrl 类不再有效。这些成员函数在MFC 中没有实现，因为它们依赖的 W indows95 的 TCM_SETCOLOR 消息没有实现。

请参阅 W in32 程序员参考中的 COLORREF

C W inApp::InitApplication

说明

在 MFC 中， C W inApp::InitApplication 成员函数已经过时了。你可能在InitApplication 中做的初始化工作应该被移到 InitInstance 中。如果你重载了C W inApp::InitApplication ，并且你没有调用基类函数，你将会漏出一个C W inApp::AddDocTemplate 加入的 CDocTemplate 对象。

请参阅 C W inApp::InitInstance

说明

这个函数已经过时。你不需要重载这个函数，因为 CWnd 的缺省实现将这个指针保存在所有的 CWnd 对象中。

结 构 、 风 格 、 回 调 函 数 和 消 息 映 射

结 构 、 风 格 、 回 调 函 数 和 消 息 映 射

MFC 使 用 的 结 构

变量名 描述

W riteClient

请 参 阅

请 参 阅

MFC 使 用 的 风 格

MFC 使 用 的 回 调 函 数

消 息 映 射

分类 描 述

消 息 映 射 的 声 明 和 分 界 宏

消 息 映 射 宏

消 息 映 射 范 围 宏

映射入口 函数原型

分类 描述

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

主题 映 射 入 口

映 射 入 口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

映射入口 函 数 原 型

旧 的 MFC 函 数

结构、风格、回调函数和消息映射

结构、风格、回调函数和消息映射

MFC 使用的结构

变量名描述

请参阅

请参阅

MFC 使用的风格

MFC 使用的回调函数

消息映射

分类描述

消息映射的声明和分界宏

消息映射宏

消息映射范围宏

映射入口函数原型

分类描述

映射入口函数原型

映射入口函数原型

映射入口函数原型

映射入口函数原型

映射入口函数原型

主题映射入口

映射入口函数原型

映射入口函数原型

映射入口函数原型

映射入口函数原型

映射入口函数原型

映射入口函数原型

映射入口函数原型

旧的 MFC 函数