Русский справочник по Win32 API

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

В случае успеха возвращаемое значение больше 32. В случае неудачи возвращаемое значение меньше или равно 32. В следующей таблице приведены возможные ошибочные значения:

Значение	Пояснение
0	Недостаток памяти или ресурсов.
31	Отсутствует ассоциация для данного типа файлов.
ERROR_FILE_NOT_FOUND	Указанный файл не найден.
ERROR_PATH_NOT_FOUND	Указанный путь не найден.
ERROR_BAD_FORMAT	Неверный формат .ЕХЕ файла (не Win32 .EXE или поврежденный файл)

Комментарии

При возвращении параметр lpResult может содержать путь к серверу DDE, запускаемому, если не получен ответ на запрос инициации DDE-диалога.

См . также

ShellExecute .

Заполненные фигуры

FrameRect

Функция FrameRect рисует границу вокруг заданного прямоугольника, используя указанную кисть. Ширина и высота границы всегда равны одной логической единице.

int FrameRect (

HDC hDC , // дескриптор контекста устройства

CONST RECT *lprc , // указатель на координаты прямоугольника

HBRUSH hbr // дескриптор кисти

);

Параметры

hDC - идентифицирует контекст устройства, в котором будет нарисована граница.

lprc - указывает на структуру типа RECT , которая содержит логические координаты верхнего левого и правого нижнего углов прямоугольника.

hbr - идентифицирует кисть, используемую для рисования границы

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

В случае успеха возвращается TRUE.

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

Комментарии

Кисть, идентифицируемая параметром hbr , должна быть создана с использованием функций CreateHatchBrush, CreatePatternBrush или CreateSolidBrush , или извлечена с использованием функции GetStockObject .

Если член bottom структуры типа RECT меньше или равен члену top , или член right меньше или равен члену left , то функция не рисует прямоугольник.

См. также

CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, GetStockObject, RECT .

Класс окна

GetClassName

Функция GetClassName извлекает имя класса, к которому принадлежит заданное окно.

int GetClassName (

HWND hWnd , // дескриптор окна

LPTSTR lpClassName , // адрес буфера для имени класса

int nMaxCount // размер буфера, в символах

);

Параметры

hWnd - идентифицирует окно и, неявно, класс, к которому оно принадлежит.

lpClassName - указывает на буфер, который получает строку с именем класса.

nMaxCount - определяет размер буфера, указанного параметром lpClassName , в символах. Строка с именем класса усекается, если ее длина больше размера буфера.

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

В случае успеха возвращается количество скопированных в буфер символов.

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

См. также

FindWindow, GetClassInfo, GetClassLong, GetClassWord .

SetClassWord

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

WORD SetClassWord (

HWND hWnd , // дескриптор окна

int nIndex , // индекс заменяемого значения

WORD wNewWord // новое значение

);

Параметры

hWnd - идентифицирует окно, и, неявно, класс, к которому принадлежит окно.

nIndex - определяет отсчитываемое от нуля смещение замещаемого значения в байтах. Верные значения находятся в диапазоне от нуля до числа байт в памяти класса минус два. Например, если вы задали десять или более байт дополнительной памяти класса, восемь будет индексом пятого 16-битного значения.

wNewWord - определяет новое значение.

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

В случае успеха возвращается предыдущее значение 16-битного целого.

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

Комментарии

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

Значения GCW _ в Win 32 API устарели. Вы должны использовать функцию SetClassLong для устновки значений класса, ранее устанавливаемых с использованием значений GCW _ функцией SetClassWord .

См. также