wNDCLASSEXA 结构 (winuser.h)
包含窗口类信息。 它与 RegisterClassEx 和 GetClassInfoEx 函数一起使用。
WNDCLASSEX 结构类似于 WNDCLASS 结构。 有两个区别。 WNDCLASSEX 包括 cbSize 成员(指定结构的大小)和 hIconSm 成员,该成员包含与窗口类关联的小图标的句柄。
语法
typedef struct tagWNDCLASSEXA {
UINT cbSize;
UINT style;
WNDPROC lpfnWndProc;
int cbClsExtra;
int cbWndExtra;
HINSTANCE hInstance;
HICON hIcon;
HCURSOR hCursor;
HBRUSH hbrBackground;
LPCSTR lpszMenuName;
LPCSTR lpszClassName;
HICON hIconSm;
} WNDCLASSEXA, *PWNDCLASSEXA, *NPWNDCLASSEXA, *LPWNDCLASSEXA;
成员
cbSize
类型: UINT
此结构的大小(以字节为单位)。 将此成员设置为 sizeof(WNDCLASSEX)
。 在调用 GetClassInfoEx 函数之前,请务必设置此成员。
style
类型: UINT
类样式 () 。 此成员可以是 类样式的任意组合。
lpfnWndProc
类型: WNDPROC
指向窗口过程的指针。 必须使用 CallWindowProc 函数调用窗口过程。 有关详细信息,请参阅 WindowProc。
cbClsExtra
类型: int
要根据窗口类结构分配的额外字节数。 系统将字节初始化为零。
cbWndExtra
类型: int
在窗口实例之后分配的额外字节数。 系统将字节初始化为零。 如果应用程序使用 WNDCLASSEX 注册使用资源文件中的 CLASS 指令创建的对话框,则必须将此成员设置为 DLGWINDOWEXTRA。
hInstance
类型: HINSTANCE
实例的句柄,该实例包含类的窗口过程。
hIcon
类型: HICON
类图标的句柄。 此成员必须是图标资源的句柄。 如果此成员为 NULL,则系统会提供默认图标。
hCursor
类型: HCURSOR
类游标的句柄。 此成员必须是游标资源的句柄。 如果此成员为 NULL,则每当鼠标移动到应用程序的窗口中时,应用程序都必须显式设置光标形状。
hbrBackground
类型: HBRUSH
类背景画笔的句柄。 此成员可以是用于绘制背景的画笔的句柄,也可以是颜色值。 颜色值必须是以下标准系统颜色之一, (值 1 必须添加到所选颜色) 。 如果提供了颜色值,则必须将其转换为以下 HBRUSH 类型之一:
- COLOR_ACTIVEBORDER
- COLOR_ACTIVECAPTION
- COLOR_APPWORKSPACE
- COLOR_BACKGROUND
- COLOR_BTNFACE
- COLOR_BTNSHADOW
- COLOR_BTNTEXT
- COLOR_CAPTIONTEXT
- COLOR_GRAYTEXT
- COLOR_HIGHLIGHT
- COLOR_HIGHLIGHTTEXT
- COLOR_INACTIVEBORDER
- COLOR_INACTIVECAPTION
- COLOR_MENU
- COLOR_MENUTEXT
- COLOR_SCROLLBAR
- COLOR_WINDOW
- COLOR_WINDOWFRAME
- COLOR_WINDOWTEXT
如果此成员为 NULL,则每当请求应用程序在其工作区中绘制时,都必须绘制自己的背景。 若要确定是否必须绘制背景,应用程序可以处理WM_ERASEBKGND消息或测试 BeginPaint 函数填充的 PAINTSTRUCT 结构的 fErase 成员。
lpszMenuName
类型: LPCTSTR
指向以 null 结尾的字符串的指针,该字符串指定类菜单的资源名称,因为名称显示在资源文件中。 如果使用整数来标识菜单,请使用 MAKEINTRESOURCE 宏。 如果此成员为 NULL,则属于此类的窗口没有默认菜单。
lpszClassName
类型: LPCTSTR
指向以 null 结尾的字符串或 的指针是原子。 如果此参数是 atom,则它必须是先前调用 RegisterClass 或 RegisterClassEx 函数创建的类 atom。 原子必须位于 lpszClassName 的低序字中;高序字必须为零。
如果 lpszClassName 是字符串,则指定窗口类名。 类名可以是使用 RegisterClass 或 RegisterClassEx 注册的任何名称,也可以是任何预定义的控件类名称。
lpszClassName 的最大长度为 256。 如果 lpszClassName 大于最大长度, 则 RegisterClassEx 函数将失败。
hIconSm
类型: HICON
与窗口类关联的小图标的句柄。 如果此成员为 NULL,系统会在 hIcon 成员指定的图标资源中搜索要用作小图标的适当大小的图标。
注解
注意
winuser.h 标头将 WNDCLASSEX 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | winuser.h (包括 Windows.h) |
请参阅
概念性
引用