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

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

Синтаксис

BOOL DestroyCaret(VOID)

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

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

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

Смотри также
CreateCaret, HideCaret, <&&local 18&&>ShowCaret

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

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