Win32 API. Каретки
Страница 15. Функция ShowCaret


Функция ShowCaret

(ПоказатьКаретку)

Функция ShowCaret делает каретку видимой на экране в текущей позиции каретки. Когда каретка становится видимой, она начинает автоматически мерцать.

Синтаксис

 
BOOL ShowCaret
(
HWND hWnd // дескриптор окна с кареткой
);

Параметры
hWnd
Идентифицирует окно, которое обладает кареткой. Если этот параметр - НОЛЬ (NULL), ShowCaret ищет текущую задачу окна, которая обладает кареткой.

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

Замечания
ShowCaret показывает каретку только в том случае, если определяемое окно обладает кареткой, каретка имеет форму и не была скрыта два или больше раз подряд. Если одно или большее количество из этих условий не выполнено, ShowCaret не делает ничего и возвращает значение ЛОЖЬ (FALSE).
Сокрытие накапливается. Если ваша прикладная программа обратились к функции HideCaret пять раз подряд, она должна также обратиться к ShowCaret пять раз прежде, чем каретка появится вновь.
Каретка - общедоступный ресурс; имеется только одна каретка в системе. Окно должно показать каретку только тогда, когда окно имеет фокус клавиатуры или активно.

Размещение и совместимость ShowCaret

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeНет
Замечания по платформеНе имеется
 
« Предыдущая статья   Следующая статья »