winuser.h


ShowCaret

La función ShowCaret hace visible el caret en pantalla en la posición actual del caret. Cuando el caret se hace visible, empieza a parpadear automáticamente.

Sintaxis

BOOL ShowCaret(
    HWND hWnd  // manipulador de ventana con caret
   );

Parámetros

hWnd: identifica la ventana a la que pertenece el caret. Si este parámetro es NULL, ShowCaret busca en el proceso activo la ventana a la que pertenece el caret.

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

ShowCaret muestra el caret sólo si la ventana especificada posee el caret, si el caret tiene una figura, y si el caret no ha sido ocultado dos o más veces seguidas. Si una o más de estas condiciones no se cumplen, ShowCaret no hace nada y devuelve FALSE.

Ocultar el carte es acumulativo. Si la aplicación llama a HideCaret cinco veces seguidas, también debe llamar a ShowCaret cinco veces seguidas para que el caret reaparezca.

El caret es un recurso compartido, sólo existe uno en el sistema. Una ventana sólo puede mostrar un caret cuando tiene el foco del teclado o cuando está activa.