Функция 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.
Смотри также
Обзор Классы окна, Функции, используемые классами окна, GetClassLong, RegisterClass, RegisterClassEx, SetClassWord, 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 |
Нет |
Замечания по платформе |
Не имеется |