Функция DestroyCaret (winuser.h)

  • Статья

Уничтожает текущую форму курсора, освобождает курсор из окна и удаляет курсор с экрана.

Синтаксис

BOOL DestroyCaret();

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

Тип: BOOL

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

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

Комментарии

DestroyCaret уничтожает курсор только в том случае, если курсор принадлежит окну в текущей задаче. Если окно, не включено в текущую задачу, владеет курсором, DestroyCaret ничего не делает и возвращает значение FALSE.

Система предоставляет по одному курсору на очередь. Окно должно создавать курсор только в том случае, если оно имеет фокус клавиатуры или активно. Окно должно уничтожить курсор, прежде чем потерять фокус клавиатуры или стать неактивным.

Пример см. в разделе Уничтожение курсора

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-caret-l1-1-0 (представлен в Windows 8)

См. также раздел

Курсоры

Основные понятия

CreateCaret

HideCaret

Справочные материалы

ShowCaret