- определяет положение горячей точки курсора по горизонтали.
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
