IPointerInactive::OnInactiveMouseMove-Methode (ocidl.h)

Artikel
08/25/2023

Benachrichtigt das Objekt, dass der Mauszeiger darüber bewegt wurde, damit das Objekt Mausereignisse auslösen kann. Diese Methode wird vom Container aufgerufen, wenn eine WM_MOUSEMOVE-Methode empfangen wird, wenn sich ein inaktives Objekt unter dem Mauszeiger befindet.

Syntax

HRESULT OnInactiveMouseMove(
  [in] LPCRECT pRectBounds,
  [in] LONG    x,
  [in] LONG    y,
  [in] DWORD   grfKeyState
);

Parameter

[in] pRectBounds

Das umschließende Rechteck des Objekts in Clientkoordinaten des enthaltenden Fensters. Dieser Parameter teilt dem Objekt seine genaue Position und Größe auf dem Bildschirm mit, wenn die WM_MOUSEMOVE Nachricht empfangen wurde. Dieser Wert wird in Einheiten des Koordinatensystems des Clients angegeben.

[in] x

Die horizontale Koordinate der Mausposition in Einheiten des enthaltenden Fensters des Clients.

[in] y

Die vertikale Koordinate der Mausposition in Einheiten des enthaltenden Fensters des Clients.

[in] grfKeyState

Der aktuelle Status der Tastaturmodifizierertasten auf der Tastatur. Mögliche Werte können eine Kombination aus beliebigen Werten MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON und MK_RBUTTON sein.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls ist es E_FAIL.

Hinweise

Der Container ruft diese Methode auf, um das Objekt zu benachrichtigen, dass sich der Mauszeiger über dem Objekt befindet, nachdem er die Aktivierungsrichtlinie des Objekts überprüft hat, indem er die IPointerInactive::GetActivationPolicy-Methode aufruft. Wenn das Objekt nicht angefordert hat, über diesen Aufruf vor Ort aktiviert zu werden, sendet der Container nachfolgende WM_MOUSEMOVE Nachrichten an das inaktive Objekt, indem OnInactiveMouseMove aufgerufen wird, solange der Mauszeiger über dem Objekt bleibt. Das -Objekt kann dann Mausverschiebungsereignisse auslösen.

Um Rundungsfehler zu vermeiden und den Auftrag für die Objektimplementierung zu erleichtern, verwendet diese Methode Fensterkoordinaten in den Einheiten des enthaltenden Clientfensters, d. h. dem Fenster, in dem das Objekt angezeigt wird, anstelle der üblichen HIMETRIC-Einheiten . Daher können die gleichen Koordinaten und Codepfade verwendet werden, wenn das Objekt aktiv und inaktiv ist. Die Fensterkoordinaten geben die Mausposition an. Das umgebende Rechteck wird auch im selben Koordinatensystem angegeben.

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	ocidl.h

Weitere Informationen

IPointerInactive

Freigeben über