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

Статья
03/15/2023

Делает курсор видимым на экране в текущем положении курсора. Когда курсор становится видимым, он начинает мигать автоматически.

Синтаксис

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

Параметры

[in, optional] hWnd

Тип: HWND

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

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

Тип: BOOL

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

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

ShowCaret показывает курсор только в том случае, если указанное окно владеет курсором, курсор имеет форму, а курсор не был скрыт два или более раз подряд. Если одно или несколько из этих условий не выполняются, ShowCaret ничего не делает и возвращает значение 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)