Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |