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

Статья
08/27/2023

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

Синтаксис

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)