Función SetCapture (winuser.h)

Artículo
08/28/2023

Establece la captura del mouse en la ventana especificada que pertenece al subproceso actual. SetCapture captura la entrada de mouse cuando el mouse está sobre la ventana de captura o cuando se presiona el botón del mouse mientras el mouse estaba sobre la ventana de captura y el botón sigue estando inactivo. Solo puede capturar el mouse una ventana a la vez.

Si el cursor del mouse está sobre una ventana creada por otro subproceso, el sistema dirigirá la entrada del mouse a la ventana especificada solo si un botón del mouse está inactivo.

Sintaxis

HWND SetCapture(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana del subproceso actual que se va a capturar el mouse.

Valor devuelto

Tipo: HWND

El valor devuelto es un identificador de la ventana que había capturado previamente el mouse. Si no hay ninguna ventana de este tipo, el valor devuelto es NULL.

Comentarios

Solo la ventana en primer plano puede capturar el mouse. Cuando una ventana de fondo intenta hacerlo, la ventana recibe mensajes solo para los eventos del mouse que se producen cuando el punto activo del cursor está dentro de la parte visible de la ventana. Además, incluso si la ventana en primer plano ha capturado el mouse, el usuario puede seguir haciendo clic en otra ventana, lo que lo lleva al primer plano.

Cuando la ventana ya no requiere toda la entrada del mouse, el subproceso que creó la ventana debe llamar a la función ReleaseCapture para liberar el mouse.

Esta función no se puede usar para capturar la entrada del mouse pensada para otro proceso.

Cuando se captura el mouse, las teclas de acceso rápido del menú y otros aceleradores de teclado no funcionan.

Ejemplos

Para obtener un ejemplo, vea Dibujar líneas con el mouse.

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-mouse-l1-1-0 (introducido en Windows 8)