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

Комментарии

CopyCursorпозволяет приложению или динамически подключаемой библиотеке ( DLL ) получить дескриптор курсора, которым владеет другой модуль. Затем, если другой модуль завершил свою работу, приложение все еще будет иметь возможность использовать этот курсор.

См. также

CopyIcon, GetCursor, SetCursor, ShowCursor.

Функция CreateCursorсоздает курсор, имеющий указанный размер, битовый шаблон и горячую точку.

HCURSOR CreateCursor(

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

int xHotSpot , // положение горячей точки по горизонтали

int yHotSpot , // положение горячей точки по вертикали

int nWidth , // ширина курсора

int nHeight , // высота курсора

CONST VOID* pvANDPlane , // указатель на массив битовой маски И

CONST VOID* pvXORPlane // указатель на массив битовой маски ИЛИ

);

Параметры

hInst - идентифицирует текущий экземпляр приложения, создающего курсор.

xHotSpot - определяет положение горячей точки курсора по горизонтали.

yHotSpot - определяет положение горячей точки курсора по вертикали.

nWidth - определяет ширину курсора в пикселях.

nHeight - определяет высоту курсора в пикселях.

pvANDplane - указывает на массив байт, содержащих значения битов для битовой маски И курсора, как в аппаратно-зависимом монохромном растровом изображении.

pvXORplane - указывает на массив байт, содержащих значения битов для битовой маски ИЛИ курсора, как в аппаратно-зависимом монохромном растровом изображении.

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

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

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

Комментарии

Значения параметров nWidth и nHeight должны указывать ширину и высоту, поддерживаемые текущим драйвером дисплея, потому что система не может создать курсоры других размеров. Для определения того, какие ширина и высота поддерживаются драйвером дисплея, вызовите функцию GetSystemMetrics, указав значения SM _ CXCURSOR и SM _ CYCURSOR .

Перед завершением приложение должно вызвать функцию DestroyCursorдля освобождение системных ресурсов, связанных с курсором.

См. также

CreateIcon, DestroyCursor, GetModuleHandle, GetSystemMetrics, SetCursor.

Функция DestroyCursorразрушает курсор, созданный функцией CreateCursor, и освобождает память, занимаемую курсором. Не используйте функцию для разрушения курсора, который не был создан функцией CreateCursor.

BOOL DestroyCursor(

HCURSOR hCursor // дескриптор разрушаемого курсора

);

Параметры

hCursor - идентифицирует разрушаемый курсор. Курсор не должен использоваться.

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

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

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

См. также

CreateCursor.

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

BOOL GetClipCursor(

LPRECT lpRect // адрес структуры для прямоугольника

);

Параметры

lpRect - указываете на структуру типа RECT, которая получает экранные координаты прямоугольника. Структура получает размеры экрана, если курсор не заключен в прямоугольник.

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

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

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

Комментарии

Курсор является разделяемым ресурсом. Если приложение заключает курсор в прямоугольную область функцией ClipCursor, оно затем должно освободить курсор, используя функцию ClipCursor ,перед тем, как уступить курсор другому приложению.

Вызывающий процесс должен иметь доступ WINSTA _ READATTRIBUTES к оконной станции ( window station ). Разъяснение термина window station смотрите в описании функции CreateWindowStation.

См. также

ClipCursor, GetCursorPos, RECT.

Функция GetCursorвозвращает дескриптор текущего курсора.

HCURSOR GetCursor( VOID)

Параметры

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

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

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

Если курсора нет, возвращает NULL.

См. также

SetCursor.

Функция GetCursorPosизвлекает положение курсора в экранных координатах.

BOOL GetCursorPos(

LPPOINT lpPoint // адрес структуры для положения курсора

);

Параметры

lpPoint - указывает на структуру типа POINT, которая получает экранные координаты курсора.

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

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

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

Комментарии

Положение курсора всегда дается в экранных координатах и не подвержено воздействию режима отображения окна, которое содержит курсор.

Вызывающий процесс должен иметь доступ WINSTA _ READATTRIBUTES к оконной станции ( window station ). Разъяснение термина window station смотрите в описании функции CreateWindowStation.

См. также

ClipCursor, POINT, SetCursor, SetCursorPos, ShowCursor.

Функция LoadCursorзагружает указанный ресурс курсора из исполняемого (. EXE ) файла, связанного с экземпляром приложения.

HCURSOR LoadCursor(

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

LPCTSTR lpCursorName // строка с именем курсора или

// идентификатор ресурса

);

Параметры

hInstance - идентифицирует экземпляр модуля, чей исполняемый файл содержит курсор.

lpCursorName - указывает на завершающуюся нулем строку, которая сдержит имя ресурса загружаемого курсора. В качестве альтернативы, значение этого параметра может содержать идентификатор ресурса в младшем слове и нуль в старшем. Используйте макрос MAKEINTRESOURCEдля создания данного значения.

Для использования предопределенных курсоров Windows установите значение параметра hInstance в NULL, а значение параметра lpCursorName в одно из следующих значений: