Функция ShowCaret делает каретку видимой на экране в текущей ее позиции. Когда каретка становится видимой, она начинает автоматически мигать.
Синтаксис
BOOL ShowCaret( HWND hWnd ); |
Параметры
hWnd
[in] Дескриптор окна, который владеет кареткой. Если этот параметр имеет значение ПУСТО (NULL), функция ShowCaret ищет текущую задачу окна, которое владеет кареткой.Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.
Замечания
Функция ShowCaret выводит на экран каретку только тогда, если заданное окно владеет кареткой, каретка имеет форму и каретка не была скрыта два или более раз подряд. Если одно или несколько этих условий не выполнены, ShowCaret не делает ничего и возвращает значение ЛОЖЬ (FALSE).
Сокрытие накапливается. Если ваше приложение обращается к функции HideCaret пять раз подряд, оно должно также обратиться пять раз и функции ShowCaret прежде, чем каретка вновь появится на экране.
Система предусматривает одну каретку на очередь. Окно должно создавать каретку только тогда, когда оно имеет фокус клавиатуры или активно. Окно должно уничтожить каретку перед потерей фокуса клавиатуры или переходом в не активный режим.
Пример смотри в статье Создание и показ на экране каретки.
Смотри также
Обзор Каретки, CreateCaret, DestroyCaret, GetCaretPos, HideCaret, SetCaretPos
|
Размещение и совместимость ShowCaret |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |