Функция GetClassLongPtr

Функция 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, RegisterClassExSetClassLongPtr, 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz