Función SetCaretPos (winuser.h)

Artículo
08/28/2023

Mueve el símbolo de intercalación a las coordenadas especificadas. Si la ventana propietaria del símbolo de intercalación se creó con el estilo de clase CS_OWNDC , las coordenadas especificadas están sujetas al modo de asignación del contexto del dispositivo asociado a esa ventana.

Sintaxis

BOOL SetCaretPos(
  [in] int X,
  [in] int Y
);

Parámetros

[in] X

Tipo: int

Nueva coordenada x del símbolo de intercalación.

[in] Y

Tipo: int

Nueva coordenada y del 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

SetCaretPos mueve el símbolo de intercalación si el símbolo de intercalación está oculto.

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. Una ventana solo puede establecer la posición de intercalación si posee el símbolo de intercalación.

Virtualización de PPP

Esta API no participa en la virtualización de PPP. La posición proporcionada se interpreta como coordenadas lógicas en términos de la ventana asociada al símbolo de intercalación. No se tiene en cuenta el subproceso que realiza la llamada.

Ejemplos

Para obtener un ejemplo, vea Crear y mostrar un símbolo de intercalación.

Requisitos

Requisito	Value
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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-caret-l1-1-0 (introducido en Windows 8)