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

Система автоматически удаляет фоновые кисти класса при отмене регистрации класса с помощью UnregisterClass. Приложение не должно удалять эти кисти.

Если этот элемент имеет значение NULL, приложение должно рисовать собственный фон всякий раз, когда ему будет предложено зарисовать в своей клиентской области. Чтобы определить, нужно ли закрашивать фон, приложение может обработать сообщение WM_ERASEBKGND или протестировать элемент fErase структуры PAINTSTRUCT , заполненной функцией BeginPaint .

lpszMenuName

Тип: LPCTSTR

Указатель на символьную строку с пустым завершением, указывающую имя ресурса в меню класса, когда имя отображается в файле ресурсов. Если для определения меню используется целое число, используйте макрос MAKEINTRESOURCE . Если этот член имеет значение NULL, окна, принадлежащие этому классу, не имеют меню по умолчанию.

lpszClassName

Тип: LPCTSTR

Указатель на строку, завершаемую null, или является атомом. Если этот параметр является atom, это должен быть атом класса, созданный при предыдущем вызове функции RegisterClass или RegisterClassEx . Атом должен быть в нижнем порядке слово lpszClassName; Слово высокого порядка должно быть равно нулю.

Если lpszClassName является строкой, она указывает имя класса окна. Имя класса может быть любым именем, зарегистрированным с помощью RegisterClass или RegisterClassEx, или любым из предопределенных имен классов элементов управления.

Максимальная длина lpszClassName — 256. Если значение lpszClassName больше максимальной длины, функция RegisterClassEx завершится ошибкой.

hIconSm

Тип: HICON

Дескриптор небольшого значка, связанного с классом окна. Если этот элемент имеет значение NULL, система выполняет поиск значка ресурса, указанного элементом hIcon , на наличие значка соответствующего размера для использования в качестве небольшого значка.

Комментарии

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	winuser.h (включая Windows.h)

См. также раздел

Основные понятия

GetClassInfoEx

Справочные материалы

RegisterClassEx

Отмена регистрацииClass

Классы окон