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

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

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

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

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

Комментарии

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

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

См. также

CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, GetStockObject, RECT.

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

int GetClassName(

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

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

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

);

Параметры

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

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

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

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

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

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

См. также

FindWindow, GetClassInfo, GetClassLong, GetClassWord.

Функция 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.

См. также

GetClassLong, GetClassWord, RegisterClass, SetClassLong, WNDCLASS.

Функция UnregisterClassудаляет класс окна, освобождая память, требуемую классу.

BOOL UnregisterClass(

LPCTSTR lpClassName , // адрес строки с именем класса

HINSTANCE hInstance // дескриптор экземпляра приложения

);

Параметры

lpClassName - указывает на завершающуюся нулем строку или целый атом. Если значение этого параметра является целым атомом, он должен быть глобальным атомом, созданным предыдущим вызовом функции GlobalAddAtom. Атом, 16-битное значение, меньшее 0 xC 000, должен находиться в младшем слове lpClassName ; старшее слово должно быть равно нулю.

Если значение lpClassName является строкой, она определяет имя класса окна. Это имя класса должно быть зарегистрировано предыдущим вызовом функции RegisterClass. Регистрация системных глобальных классов, таких, как классы элементов управления, не может быть отменена.

hInstance - определяет экземпляр модуля, создавшего класс.

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

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

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

Комментарии

Перед вызовом этой функции приложение должно разрушить все окна, созданные с указанным классом.

Регистрация всех классов окон, которые зарегистрировало приложение, должна быть отменена при его завершении.

См. также

GlobalAddAtom, RegisterClass.

Функция GetDoubleClickTimeизвлекает текущее время двойного щелчка мыши. Двойной щелчок - это серия двух щелчков клавиши мыши; второй щелчок происходит в течение заданного времени после первого. Время двойного щелчка - это максимальное число миллисекунд, которые могут пройти между первым и вторым щелчками в двойном щелчке.

UINT GetDoubleClickTime( VOID)

Параметры

Функция не имеет параметров.

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

В случае успеха возвращается время двойного щелчка в миллисекундах.

См. также

SetDoubleClickTime.

Функция GetArcDirectionвозвращает текущее направление рисования дуг для указанного контекста устройства. Функции рисования дуг и прямоугольников используют эту функцию.

int GetArcDirection(

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

);

Параметры

hdc - идентифицирует контекст устройства.

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

В случае успеха возвращается текущее направление рисования. Может принимать одно из следующих значений:

В случае ошибки возвращается нуль.

См. также

SetArcDirection.

Функция LineDDAProcявляется определяемой приложением функцией обратного вызова, используемой совместно с функцией LineDDA. Функция LineDDAProcиспользуется для обработки координат. Тип LINEDDAPROCопределяет указатель на эту функцию обратного вызова. LineDDAProcявляется "заполнителем" для имени определяемой приложением функции.