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

• Название: Русский справочник по Win32 API
• Автор: Тарас Сорока
• Жанр: Программирование

---

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

См. также

GlobalAddAtom, RegisterClass .

Ввод мышью

GetDoubleClickTime

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

UINT GetDoubleClickTime ( VOID )

Параметры

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

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

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

См. также

SetDoubleClickTime .

Прямые и кривые

GetArcDirection

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

int GetArcDirection (

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

);

Параметры

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

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

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

Значение

Пояснение

AD_COUNTERCLOCKWISE

Дуги и прямоугольники рисуются против часовой стрелки.

AD_CLOCKWISE

Дуги и прямоугольники рисуются по часовой стрелке.

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

См. также

SetArcDirection .

LineDDAProc

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

VOID CALLBACK LineDDAProc (

int X , // x -координата точки

int Y , // у-координата точки

LPARAM lpData // определяемые приложением данные

);

Параметры

X - определяет х-координату текущей точки в логических единицах.

Y - определяет y -координату текущей точки в логических единицах.

lpData - указатель на определяемые приложением данные.

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

Функция не возвращает значения.

Комментарии

Приложение регистрирует функцию LineDDAProc , передавая ее адрес в функцию LineDDA.

Требования

Windows NT/2000/XP: Включена в Windows NT 3.1 и выше.

Windows 95/98/Me: Включена в Windows 95 и выше.

Заголовок: Объявлена в Wingdi.h; подключать Windows.h.

См. также

LineDDA.

LineTo

Функция LineTo рисует линию из текущей позиции до указанной точки, не включая ее.

BOOL LineTo (

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

int nXEnd , // x -координата завершающей линию точки

int nYEnd // y - координата завершающей линию точки

);

Параметры

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

nXEnd - определяет x -координату завершающей линию точки.

nYEnd - определяет y -координату завершающей линию точки.

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

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

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

Комментарии

Координаты завершающей точки линии указываются в логических единицах.

Линия рисуется текущим пером, и, если перо является геометрическим пером, текущей кистью.

В случае успеха LineTo , текущая позиция устанавливается в указанную завершающую точку.

См. также

MoveToEx, Polyline, PolylineTo .

MoveToEx

Функция MoveToEx устанавливает текущей позицией указанную точку и, необязательно, возвращает предыдущую позицию.

BOOL MoveToEx (

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

int X , // x -координата новой текущей позиции

int Y , // y - координата новой текущей позиции

LPPOINT lpPoint // адрес старой текущей позиции

);

Параметры

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

X - определяет x -координату новой текущей позиции в логических единицах.

Y - определяет y -координату новой текущей позиции в логических единицах.

lpPoint - указывает на структуру типа POINT , в которой хранится предыдущая текущая позиция. Если значение этого параметра равно NULL, предыдущая позиция не возвращается.

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

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

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

Комментарии

Функция MoveToEx воздействует на все функции рисования.

См. также

AngleArc, LineTo, POINT, PolyBezierTo, PolylineTo .

Polyline

Функция Polyline рисует серию отрезков прямых, соединяя точки в указанном массиве.

BOOL Polyline (

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

CONST POINT * lppt , // адрес массива с точками

int cPoints // количество точек в массиве

);

Параметры

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

lppt - указатель на массив структур типа POINT . Каждая структура в массиве идентифицирует точку в логическом пространстве.

cPoints - определяет количество точек в массиве. Значение этого параметра должно быть больше или равно двум.

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

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

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

Комментарии

Линии рисуются текущим пером с первой точки через последующие. В отличие от функции LineTo , функция Polyline не использует и не обновляет текущую позицию.

См. также

LineTo, MoveToEx, POINT, PolylineTo, PolyPolyline .

PolylineTo

Функция PolylineTo рисует серию отрезков прямых, соединяя точки в указанном массиве.

BOOL PolylineTo (

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

CONST POINT * lppt , // адрес массива с точками

int cPoints // количество точек в массиве

);

Параметры

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

lppt - указатель на массив структур типа POINT . Каждая структура в массиве идентифицирует точку в логическом пространстве.

cPoints - определяет количество точек в массиве.

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

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

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

Комментарии

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

PolylineTo перемешает текущую позицию в завершающую точку последнего отрезка.

Если отрезки прямых, нарисованные функцией, образуют замкнутую фигуру, то она не закрашивается.

См. также

LineTo, MoveToEx, POINT, Polyline .

PolyPolyline

Функция PolyPolyline рисует множественные серии соединенных отрезков прямых.

BOOL PolyPolyline (

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

CONST POINT * lppt , // адрес массива с точками

CONST DWORD * lpdwPolyPoints , // адрес массива значений