Win32 API. Каретки - Функция DestroyCaret

ОГЛАВЛЕНИЕ

Функция DestroyCaret

(РазрушитьКаретку)

Функция DestroyCaret уничтожает текущую форму каретки, освобождает каретку от окна и удаляет каретку с экрана. Если форма каретки основана на точечном рисунке, DestroyCaret не освобождает точечный рисунок.

Синтаксис

BOOL DestroyCaret(VOID)

Параметры
У этой функции нет параметров.

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

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

Смотри также
CreateCaret, HideCaret, ShowCaret

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

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