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