Функция SetCursor устанавливает форму курсора.
Синтаксис
HCURSOR SetCursor( HCURSOR hCursor ); |
Параметры
hCursor
[in] Дескриптор курсора. Курсор, должен быть создан функцией
CreateCursor или загружен функцией LoadCursor или LoadImage. Если этот параметр имеет значение ПУСТО (NULL), курсор удаляется с экрана.Windows 95/98/Me: ширина и высота курсора должны быть значениями SM_CXCURSOR и SM_CYCURSOR, возвращенными функцией GetSystemMetrics. Для Windows® 95, или битовая глубина цвета курсора должна соответствовать битовой глубине цвета дисплея, или курсор должен быть одноцветным. Однако, для Windows 98 и Windows Me, если битовая глубина цвета курсора не соответствует битовой глубине цвета дисплея, то курсор преобразуется в цвет 4 бита на пиксель (bpp) VGA.
Возвращаемое значение
Возвращаемое значение - дескриптор предыдущего курсора, если он был.
Если не было никакого предыдущего курсора, возвращаемое значение - ПУСТО (NULL).
Замечания
Курсор устанавливается только тогда, если новый курсор отличается от предыдущего курсора; иначе, функция немедленно возвращает значение.
Курсор - совместно используемый ресурс. Окно должно устанавливать форму курсора только тогда, когда курсор находится в его рабочей области или когда окно захватило ввод данных от мыши. В системах без мыши, окно должно восстановить предыдущий курсор до того, как он оставит рабочую область, или до того, как система передаст управление другому окну.
Если ваша прикладная программа должна установить курсор, в то время когда он находится в окне, удостоверитесь, что курсор класса в классе определяемого окна установлен в значение ПУСТО (NULL). Если курсор класса - не ПУСТО (NULL), система восстанавливает курсор класса, каждый раз, когда перемещается мышь.
Курсор не показывается на экране, если внутренний счетчик отображения курсора - меньше чем нуль. Это происходит тогда, когда прикладная программа использует функцию ShowCursor для сокрытия курсора большее количество времени, чем для его показа на экране.
Пример
Пример смотри в статье Показ курсора на экране.
Смотри также
Обзор Курсоры, CreateCursor, GetCursor, GetSystemMetrics, LoadCursor, LoadImage, SetCursorPos, ShowCursor
|
Размещение и совместимость SetCursor |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |