Функция GetClassLongPtr извлекает заданное значение из структуры WNDCLASSEX, связанной с указанным окном.
Если Вы извлекаете указатель или дескриптор, эта функция заменяет функцию GetClassLong. (Указатели и дескрипторы - это 32 бита в 32-разрядном Microsoft ® Windows ® и 64 бита в 64-разрядном Windows.) Чтобы написать код, который является совместимым и с 32-разрядными и с 64-разрядными версиями Windows, используйте функцию GetClassLongPtr.
Синтаксис
ULONG_PTR GetClassLongPtr( HWND hWnd, int nIndex ); |
Параметры
hWnd
[in] Дескриптор окна и, косвенно, класс, которому принадлежит окно.nIndex
[in] Устанавливает извлекаемое значение. Чтобы извлечь значение из дополнительной памяти класса, установите положительное, отсчитываемое от нуля смещение байта извлекаемого значения. Допустимые значения находятся в диапазоне от нуля до числа байтов дополнительной памяти класса, минус восемь; например, если Вы определили 24 или больше байт дополнительной памяти класса, значение 16 будет индексом третьего целого число. Чтобы извлечь какое-либо другое значение из структуры WNDCLASSEX, установите одно из ниже перечисленных значений.
Значение | Предназначение |
GCW_ATOM | Извлекает значение АТОМА, которое уникально идентифицирует класс окна. Это - тот же самый атом, значение которого возвращает функция RegisterClassEx. |
GCL_CBCLSEXTRA | Извлекает данные о размере дополнительной памяти, связанной с классом, в байтах. |
GCL_CBWNDEXTRA | Извлекает данные о размере дополнительной памяти окна, связанной с каждым окном в классе, в байтах. За информацией относительно того, как получить доступ к этой памяти, см. описание функции GetWindowLongPtr. |
GCLP_HBRBACKGROUND | Извлекает дескриптор кисти фона, связанной с классом. |
GCLP_HCURSOR | Извлекает дескриптор курсора, связанного с классом. |
GCLP_HICON | Извлекает дескриптор значка, связанного с классом. |
GCLP_HICONSM | Извлекает дескриптор маленького значка, связанного с классом. |
GCLP_HMODULE | Извлекает дескриптор модуля, который зарегистрировал класс. |
GCLP_MENUNAME | Извлекает указатель на строку с именем меню. Строка идентифицирует ресурс меню, связанный с классом. |
GCL_STYLE | Извлекает данные о битах стиля класса окна. |
GCLP_WNDPROC | Извлекает адрес оконной процедуры, или дескриптора, обозначающего адрес оконной процедуры. Чтобы вызвать оконную процедуру, Вы должны использовать функцию CallWindowProc. |
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - затребованная величина.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Резервируйте дополнительную память класса, определяя ненулевое значение в члене cbClsExtra структуры WNDCLASSEX, используемой функцией RegisterClassEx.
Смотри также
Обзор Классы окна, Функции, используемые классами окна, GetWindowLongPtr, RegisterClassEx, SetClassLongPtr, WNDCLASS
Размещение и совместимость GetClassLongPtr |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |