CopyCursor
Функция CopyCursor копирует курсор.
HCURSOR CopyCursor (
HCURSOR pcur // дескриптор копируемого курсора
);
Параметры
pcur - идентифицирует копируемый курсор.
Возвращаемые значения
В случае успеха возвращается дескриптор курсора-копии.
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
CopyCursor позволяет приложению или динамически подключаемой библиотеке ( DLL ) получить дескриптор курсора, которым владеет другой модуль. Затем, если другой модуль завершил свою работу, приложение все еще будет иметь возможность использовать этот курсор.
См. также
CopyIcon, GetCursor, SetCursor, ShowCursor .
CreateCursor
Функция 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
Функция DestroyCursor разрушает курсор, созданный функцией CreateCursor , и освобождает память, занимаемую курсором. Не используйте функцию для разрушения курсора, который не был создан функцией CreateCursor .
BOOL DestroyCursor (
HCURSOR hCursor // дескриптор разрушаемого курсора
);
Параметры
hCursor - идентифицирует разрушаемый курсор. Курсор не должен использоваться.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
CreateCursor .
GetClipCursor
Функция GetClipCursor извлекает экранные координаты прямоугольной области, в которую заключен курсор.
BOOL GetClipCursor (
LPRECT lpRect // адрес структуры для прямоугольника
);
Параметры
lpRect - указываете на структуру типа RECT , которая получает экранные координаты прямоугольника. Структура получает размеры экрана, если курсор не заключен в прямоугольник.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Курсор является разделяемым ресурсом. Если приложение заключает курсор в прямоугольную область функцией ClipCursor , оно затем должно освободить курсор, используя функцию ClipCursor , перед тем, как уступить курсор другому приложению.
Вызывающий процесс должен иметь доступ WINSTA _ READATTRIBUTES к оконной станции ( window station ). Разъяснение термина window station смотрите в описании функции CreateWindowStation .
См. также
ClipCursor, GetCursorPos, RECT .
GetCursor
Функция GetCursor возвращает дескриптор текущего курсора.
HCURSOR GetCursor ( VOID )
Параметры
Функция не имеет параметров.
Возвращаемые значения
В случае успеха функция возвращает дескриптор текущего курсора.
Если курсора нет, возвращает NULL.
См. также
SetCursor .
GetCursorPos
Функция GetCursorPos извлекает положение курсора в экранных координатах.
BOOL GetCursorPos (
LPPOINT lpPoint // адрес структуры для положения курсора
);
Параметры
lpPoint - указывает на структуру типа POINT , которая получает экранные координаты курсора.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.