winuser.h


DestroyCaret

La función DestroyCaret destruye la figura del caret actual, libera el caret de la ventana y lo quita de la pantalla.

Si la figura del caret se basa en un mapa de bits, DestroyCaret no libera ese mapa de bits.

Sintaxis

BOOL DestroyCaret(VOID)

Parámetros

Esta función no tiene parámetros.

Valor de retorno

Si la función tiene éxito, el valor de retorno será distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

DestroyCaret destruye el caret sólo si una ventana en el proceso actual lo posee. Si una ventana que no pertenece al proceso actual posee el caret, DestroyCaret no hace nada y devuelve FALSE.

El caret es un recurso compartido, sólo existe uno en el sistema. Una ventana sólo debe crear un caret cuando tiene el foco del teclado o cuando está activa. Sólo debe destruirlo antes de perder el foco del teclado o de quedar desactivada.