Функция ShowCaret

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz