GetClassLong

GetClassLong функция извлекает указанное 32-разрядное значение (длинная) из WNDCLASSEX структуры, связанные с указанным окном.

() DWORD GetClassLong HWND  hWnd, / / обработать окнаintnIndex / / смещение от возвращаемого значения);
 

Параметры

hWnd
Дескриптор окна и, косвенно, класс, к которому принадлежит окно.
nIndex
Задает 32-разрядное значение для извлечения. Чтобы получить 32-битное значение из памяти высшего сорта, укажите позитивный, с нуля смещение значения для извлечения. Допустимые значения находятся в диапазоне от нуля до количество байтов памяти, высшего сорта, четыре; например при указании 12 или более байтов памяти, высшего сорта, значение 8 бы индекс третьего 32-разрядное целое число. Для получения любого другого значения из структуры WNDCLASSEX , укажите одно из следующих значений:
Значение Действия
GCW_ATOM Извлекает значение атома , которое уникально идентифицирует класс окна. Это же атом функцией RegisterClassEx.
GCL_CBCLSEXTRA Получает размер, в байтах, дополнительной памяти, связанной с классом.
GCL_CBWNDEXTRA Получает размер, в байтах, дополнительное окно памяти, связанной с каждым окном в классе. Сведения о том, как получить доступ к этой памяти содержатся в разделе GetWindowLong.
GCL_HBRBACKGROUND Получает дескриптор фон кисти, связанные с классом.
GCL_HCURSOR Получает дескриптор курсора, связанные с классом.
GCL_HICON Получает дескриптор значка, связанного с классом.
GCL_HICONSM Получает дескриптор маленький значок, связанный с классом.
GCL_HMODULE Получает дескриптор модуля, зарегистрированного класса.
GCL_MENUNAME Извлекает адрес имя строки меню. Строка идентифицирует ресурс меню, связанные с классом.
GCL_STYLE Извлекает битов стиля класса окна.
GCL_WNDPROC Извлекает адрес процедуры окна, связанный с классом.

Возвращаемые значения

Если функция выполнена успешно, возвращаемое значение является запрашиваемое 32-битное значение.

Если вызов функции был неуспешен, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

Резервировать память высшего сорта, указав ненулевое значение в cbClsExtra член WNDCLASSEX структуры, используется с функцией RegisterClassEx.

Windows CE: Параметр nIndex — байта смещение, но должна быть кратна 4 байта. Windows CE не поддерживает невыровненных доступ.

Только значения, поддерживаемые для параметра nIndex являются GCL_HICON и GCL_STYLE.

Если вы используете Windows CE Iconcurs компонента, который поддерживает курсоры мыши на соответствующих целевых платформах, можно также использовать значение GCL_HCURSOR в параметре nIndex.

Примечание Версий Windows CE, которые поддерживают курсоры мыши включают в себя компоненты Iconcurs и Mcursor, а не значок и курсор компонентов.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор окна классов, функции класса окна, GetWindowLong, RegisterClassEx, SetClassLong, WNDCLASSEX

Index