Compartir a través de


Función ShowCaret (winuser.h)

Hace que el símbolo de intercalación sea visible en la pantalla en la posición actual del símbolo de intercalación. Cuando el símbolo de intercalación se vuelve visible, comienza a parpadear automáticamente.

Sintaxis

BOOL ShowCaret(
  [in, optional] HWND hWnd
);

Parámetros

[in, optional] hWnd

Tipo: HWND

Identificador de la ventana que posee el símbolo de intercalación. Si este parámetro es NULL, ShowCaret busca en la ventana que posee el símbolo de intercalación.

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

ShowCaret muestra el símbolo de intercalación solo si la ventana especificada posee el símbolo de intercalación, el símbolo de intercalación tiene una forma y el símbolo de intercalación no se ha ocultado dos o más veces en una fila. Si no se cumple una o varias de estas condiciones, ShowCaret no hace nada y devuelve FALSE.

La ocultación es acumulativa. Si la aplicación llama a HideCaret cinco veces en una fila, también debe llamar a ShowCaret cinco veces antes de que vuelva a aparecer el símbolo de intercalación.

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.

Ejemplos

Para obtener un ejemplo, vea Crear y mostrar 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

DestroyCaret

GetCaretPos

HideCaret

Referencia

SetCaretPos