Función SetCapture (winuser.h)

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

Consulte también

Conceptual

GetCapture

Entrada de mouse

Referencia

ReleaseCapture

WM_CAPTURECHANGED