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 .