SetCapture-Funktion (winuser.h)

Legt die Mausauswahl auf das angegebene Fenster im aktuellen Thread fest. SetCapture erfasst Mauseingaben entweder, wenn sich die Maus über dem erfassenden Fenster befindet, oder wenn die Maustaste gedrückt wurde, während sich die Maus über dem erfassenden Fenster befand und die Taste noch gedrückt ist. Nur jeweils ein Fenster kann die Maus erfassen.

Wenn sich der Mauszeiger über einem Fenster befindet, das von einem anderen Thread erstellt wurde, leitet das System die Mauseingabe nur dann an das angegebene Fenster weiter, wenn eine Maustaste gedrückt ist.

Syntax

HWND SetCapture(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster im aktuellen Thread, das die Maus erfassen soll.

Rückgabewert

Typ: HWND

Der Rückgabewert ist ein Handle für das Fenster, das zuvor die Maus erfasst hatte. Wenn kein solches Fenster vorhanden ist, ist der Rückgabewert NULL.

Hinweise

Die Maus kann nur im Vordergrundfenster erfasst werden. Wenn ein Hintergrundfenster dies versucht, empfängt das Fenster nur Meldungen für Mausereignisse, die auftreten, wenn sich der Cursor-HotSpot innerhalb des sichtbaren Teils des Fensters befindet. Außerdem gilt: Der Benutzer kann weiterhin auf ein anderes Fenster klicken und es so in den Vordergrund holen, auch wenn das Vordergrundfenster die Maus erfasst hat.

Wenn das Fenster nicht mehr alle Mauseingaben erfordert, sollte der Thread, der das Fenster erstellt hat, die ReleaseCapture-Funktion aufrufen, um die Maus loszulassen.

Diese Funktion kann nicht zum Erfassen von Mauseingaben verwendet werden, die für einen anderen Prozess bestimmt sind.

Wenn die Maus erfasst wird, funktionieren Menü-Hotkeys und andere Tastenkombinationen nicht.

Beispiele

Ein Beispiel finden Sie unter Zeichnen von Linien mit der Maus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-mouse-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

GetCapture

Mauseingabe

Referenz

ReleaseCapture

WM_CAPTURECHANGED