Win32 API. Курсоры
Страница 25. Функция SetSystemCursor


Функция SetSystemCursor

(УстановитьСистемныйКурсор)

Функция SetSystemCursor заменяет содержимое системного курсора, заданного идентификатором id содержимым курсора, заданного hcur, и затем уничтожает hcur. Эта функция позволяет прикладной программе настраивать курсоры системы.

Синтаксис

BOOL SetSystemCursor 
(
HCURSOR hcur,// устанавливает заданный курсор системы в содержимом этого
//курсора, эатем уничтожает его

DWORD id// курсор системы, заданный его идентификатором
);

Параметры
hcur
Дескриптор курсора. Функция заменяет содержимое курсора системы, заданного идентификатором id, содержимым курсора, обработанного при помощи hcur. Затем функция уничтожает hcur, вызывая DestroyCursor (hCursor).
id
Идентификатор курсора системы. Функция заменяет содержимое этого курсора системы содержимым курсора, обработанного при помощи hcur.
Ниже следует список идентификаторов курсоров системы:

  • OCR_NORMAL - Обычный курсор-стрелка
  • OCR_IBEAM - I-образный курсор
  • OCR_WAIT - Курсор в виде больших песочных часов
  • OCR_CROSS - Курсор в виде креста
  • OCR_UP - Курсор стрелка вверх
  • OCR_SIZE - Курсор размера (четырех направленная стрелка)
  • OCR_ICON - Курсор в виде пиктограммы
  • OCR_SIZENWSE - Курсор изменения размера (двунаправленная стрелка СЗ - ЮВ)
  • OCR_SIZENESW - Курсор изменения размера (двунаправленная стрелка СВ - ЮЗ)
  • OCR_SIZEWE - Курсор изменения размера по горизонтали
  • OCR_SIZENS - Курсор изменения размера по вертикали
  • OCR_SIZEALL - Курсор изменения размера по вертикали и горизонтали
  • OCR_SIZENO - Международный символ отсутствия курсора
  • OCR_APPSTARTING - Курсор в виде стрелки с маленькими песочными часами

Возвращаемые значения
Если функция завершилась успешно, возвращается значение отличное от нуля.
Если функция потерпела неудачу, возвращаемое значение - ноль. Чтобы получить расширенные данные об ошибках, обратитесь к функции GetLastError.

Смотри также
DestroyCursor, LoadCursor, LoadCursorFromFile, SetCursor

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

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeНет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »