Поделиться через


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

Удаляет курсор с экрана. Скрытие курсора не приводит к разрушению его текущей фигуры и не к аннулированию точки вставки.

Синтаксис

BOOL HideCaret(
  [in, optional] HWND hWnd
);

Параметры

[in, optional] hWnd

Тип: HWND

Дескриптор окна, которому принадлежит курсор. Если этот параметр имеет значение NULL, Функция HideCaret выполняет поиск в текущей задаче окна, которому принадлежит курсор.

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

Тип: BOOL

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

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

Комментарии

HideCaret скрывает курсор только в том случае, если указанное окно владеет курсором. Если указанное окно не является владельцем курсора, HideCaret ничего не делает и возвращает значение FALSE.

Скрытие является накопительным. Если приложение вызывает HideCaret пять раз подряд, оно также должно вызывать ShowCaret пять раз перед отображением курсора.

Пример см. в разделе Скрытие курсора.

Требования

   
Минимальная версия клиента 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

DestroyCaret

GetCaretPos

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

SetCaretPos

ShowCaret