Metodo IPointerInactive::OnInactiveMouseMove (ocidl.h)

Articolo
08/25/2023

Notifica all'oggetto che il puntatore del mouse è stato spostato su di esso in modo che l'oggetto possa generare eventi del mouse. Questo metodo viene chiamato dal contenitore alla ricezione di un metodo WM_MOUSEMOVE quando un oggetto inattivo si trova sotto il puntatore del mouse.

Sintassi

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

Parametri

[in] pRectBounds

Rettangolo di delimitazione dell'oggetto, nelle coordinate client della finestra contenitore. Questo parametro indica all'oggetto la posizione esatta e le dimensioni sullo schermo quando è stato ricevuto il messaggio di WM_MOUSEMOVE. Questo valore viene specificato in unità di misura del sistema di coordinate del client.

[in] x

Coordinata orizzontale della posizione del mouse in unità della finestra contenitore del client.

[in] y

Coordinata verticale della posizione del mouse in unità della finestra contenitore del client.

[in] grfKeyState

Stato corrente dei tasti di modifica della tastiera sulla tastiera. I valori possibili possono essere una combinazione di qualsiasi valore MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON e MK_RBUTTON.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene S_OK. In caso contrario, è E_FAIL.

Commenti

Il contenitore chiama questo metodo per notificare all'oggetto che il puntatore del mouse si trova sull'oggetto dopo aver controllato i criteri di attivazione dell'oggetto chiamando il metodo IPointerInactive::GetActivationPolicy . Se l'oggetto non ha richiesto di essere attivato sul posto tramite tale chiamata, il contenitore invia messaggi successivi WM_MOUSEMOVE all'oggetto inattivo chiamando OnInactiveMouseMove purché il puntatore del mouse rimanga sull'oggetto. L'oggetto può quindi generare eventi di spostamento del mouse.

Per evitare errori di arrotondamento e rendere più semplice il processo sull'implementatore dell'oggetto, questo metodo accetta le coordinate delle finestre nelle unità di misura della finestra client che lo contiene, ovvero la finestra in cui viene visualizzato l'oggetto, anziché le normali unità HIMETRIC . Di conseguenza, è possibile usare le stesse coordinate e il percorso del codice quando l'oggetto è attivo e inattivo. Le coordinate della finestra specificano la posizione del mouse. Il rettangolo di delimitazione viene specificato anche nello stesso sistema di coordinate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IPointerInactive

Condividi tramite