Функция 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	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки