Функция GetClassWord


Функция GetClassWord извлекает 16-разрядное (WORD) значение при заданном смещении в дополнительной памяти класса для класса окна, которому указанное окно принадлежит.

Обратите внимание! на то, что эта функция предусматривается только для совместимости с 16-разрядными версиями Microsoft ® Windows ®. Прикладные программы должны использовать функцию GetClassLong.

Синтаксис

WORD GetClassWord(      
    HWND hWnd,
    int nIndex
);

Параметры

hWnd

[in] Дескриптор окна и, косвенно, класс которому окно принадлежит.

nIndex

[in] Устанавливает отсчитываемое от нуля значение извлекаемого смещения. Допустимые значения находятся в  диапазоне от нуля до числа байтов памяти класса, минус два; например, если Вы определили 10 или больше байтов дополнительной памяти класса, значение восемь будет индексом к пятому 16-разрядному целому числу. Имеются и  дополнительные допустимое значения которые показаны в следующей ниже таблице.

 

Значение Предназначение
GCW_ATOM Извлекает значение АТОМ, которое уникально идентифицирует класс окна. Это - тот же самый атом, который возвращает функция RegisterClass или RegisterClassEx.
GCW_HICONSM Извлекает дескриптор маленького значка, связанного с окном.

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

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

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

Замечания

Резервируйте дополнительную память класса, определяя ненулевое значение в члене cbClsExtra структуры WNDCLASS, используемой с функцией RegisterClass.

Смотри также

Обзор Классы окна, Функции, используемые классами окна, GetClassLongRegisterClassRegisterClassExSetClassWord, WNDCLASSEX

Размещение и совместимость GetClassWord

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