Función DestroyCaret (winuser.h)

Destruye la forma actual del símbolo de intercalación, libera el símbolo de intercalación de la ventana y quita el símbolo de intercalación de la pantalla.

Sintaxis

BOOL DestroyCaret();

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

DestroyCaret destruye el símbolo de intercalación solo si una ventana de la tarea actual posee el símbolo de intercalación. Si una ventana que no está en la tarea actual posee el símbolo de intercalación, DestroyCaret no hace nada y devuelve FALSE.

El sistema proporciona un símbolo de intercalación por cola. Una ventana debe crear un símbolo de intercalación solo cuando tenga el foco del teclado o esté activo. La ventana debe destruir el símbolo de intercalación antes de perder el foco del teclado o volverse inactivo.

Para obtener un ejemplo, vea Destruir un símbolo de intercalación.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-caret-l1-1-0 (introducido en Windows 8)

Consulte también

Símbolos de intercalación

Conceptual

CreateCaret

HideCaret

Referencia

ShowCaret