Функция CreateCursor

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

Синтаксис

HCURSOR CreateCursor(
    HINSTANCE hInst,
    int xHotSpot,
    int yHotSpot,
    int nWidth,
    int nHeight,
    const VOID* pvANDPlane,
    const VOID* pvXORPlane
);

Параметры

hInst

[in] Дескриптор текущего экземпляра приложения, создающего курсор.

xHotSpot

[in] Устанавливает горизонтальную позицию острия курсора.

yHotSpot

[in] Устанавливает вертикальную позицию острия курсора.

nWidth

[in] Устанавливает ширину курсора, в пикселях.

nHeight

[in] Устанавливает высоту курсора, в пикселях.

pvANDPlane

[in] Указатель на массив байтов, который содержит битовые значения маски AND для курсора, как в аппаратно-зависимом одноцветном точечном рисунке.

pvXORPlane

[in] Указатель на массив байтов, который содержит значения битов маски XOR для курсора, как в аппаратно-зависимом одноцветном точечном рисунке.

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

Если функция завершается успешно, возвращаемое значение - дескриптор курсора.

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите(назовите) GetLastError.

Замечания

Параметры nWidth и nHeight должны устанавливать ширину и высоту, которые поддерживаются текущим драйвером дисплея, потому что система не может создавать курсоры других размеров. Чтобы определить ширину и высоту, поддерживаемую драйвером дисплея, используйте функцию GetSystemMetrics, установив значение SM_CXCURSOR или SM_CYCURSOR.

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

Пример

Пример, см. в статье Создание курсора.

Смотри также

Обзор КурсорыCreateIcon, DestroyCursor, GetModuleHandle, GetSystemMetrics, SetCursor

Размещение и совместимость  CreateCursor

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz