SetCapture

Die SetCapture -Funktion legt die Mausauswahl auf das angegebene Fenster an den aktuellen Thread gehören. Sobald ein Fenster die Maus erfasst hat, alle Maus-Eingaben zu diesem Fenster, unabhängig davon, ob der Cursor innerhalb der Grenzen des Fensters gerichtet ist. Nur ein Fenster zu einem Zeitpunkt kann die Maus erfassen.

Wenn der Mauszeiger über ein Fenster von einem anderen Thread erstellt wird, wird das System direkt Mauseingaben für das angegebene Fenster nur, wenn eine Maustaste gedrückt ist.

(HWND SetCapture HWND  hWnd / / handle des Fensters, um Mauseingaben zu erhalten);
 

Parameter

hWnd
Handle für das Fenster in der aktuellen Diskussion, die die Maus erfassen.

Rückgabewerte

Der Rückgabewert ist das Handle des Fensters, die zuvor die Maus erfasst hatte. Wenn es kein solches Fenster, ist der Rückgabewert NULL.

Bemerkungen

Nur das Vordergrundfenster kann die Maus erfassen. Wenn ein Hintergrundfenster versucht, dies zu tun, erhält das Fenster nur Meldungen für Mausereignisse, die auftreten, wenn der Cursorhotspot innerhalb des sichtbaren Bereichs des Fensters ist. Außerdem, selbst wenn das Vordergrundfenster die Maus erfasst hat, kann der Benutzer noch ein weiteres Fenster, klicken in den Vordergrund zu bringen.

Wenn das Fenster nicht mehr alle Mauseingabe erfordert, sollte der Thread, der das Fenster erstellt die Funktion ReleaseCapture , um die Maustaste loslassen aufrufen.

Diese Funktion kann nicht verwendet werden, um Mauseingaben bedeutete für einen anderen Prozess zu erfassen.

Windows 95: SetCapture Aufruf bewirkt, dass das Fenster, das die Mausauswahl zum Empfangen einer Meldung WM_CAPTURECHANGED verliert.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Eingabe der Maus, Maus Input Funktionen, GetCapture, ReleaseCapture, WM_CAPTURECHANGED

Index