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