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