wNDCLASSEXA 结构 (winuser.h)

项目
05/25/2023

包含窗口类信息。它与 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

使用 UnregisterClass 注销类时，系统会自动删除类背景画笔。应用程序不应删除这些画笔。

如果此成员为 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)

请参阅

概念性

引用

wNDCLASSEXA 结构 (winuser.h)

语法

成员

注解

要求

请参阅

反馈

反馈

其他资源