Metodo IPointerInactive::GetActivationPolicy (ocidl.h)

Recupera i criteri di attivazione correnti per l'oggetto . Questo metodo viene chiamato dal contenitore alla ricezione di un messaggio di WM_SETCURSOR o WM_MOUSEMOVE quando un oggetto inattivo si trova sotto il puntatore del mouse.

Sintassi

HRESULT GetActivationPolicy(
  [out] DWORD *pdwPolicy
);

Parametri

[out] pdwPolicy

Puntatore a una variabile che riceve i criteri di attivazione. I valori possibili provengono dall'enumerazione POINTERINACTIVE .

Valore restituito

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

Commenti

L'oggetto può richiedere di essere attivato sul posto non appena il mouse lo immette attraverso il valore POINTERINACTIVE_ACTIVATEONENTRY. Oggetto che fornisce un feedback più visivo rispetto all'impostazione semplice del puntatore del mouse userebbe questo valore. Ad esempio, se l'oggetto supporta un feedback visivo speciale, deve immettere lo stato attivo in modo che possa disegnare il feedback visivo supportato.

Un oggetto può anche usare questo metodo per richiedere l'attivazione quando il mouse viene trascinato su di essi durante un'operazione di trascinamento della selezione attraverso il POINTERINACTIVE_ACTIVATEONDRAG.

Se l'oggetto restituisce uno di questi valori, il contenitore deve attivare l'oggetto immediatamente e inoltrare il messaggio Window che ha attivato la chiamata. L'oggetto rimane quindi attivo ed elabora i messaggi successivi tramite la propria finestra fino a quando il contenitore non ottiene un altro WM_SETCURSOR o WM_MOUSEMOVE. A questo punto, il contenitore deve disattivare l'oggetto.

Per gli oggetti OLE senza finestra questo meccanismo è leggermente diverso. Per altre informazioni sulle operazioni di trascinamento della selezione per gli oggetti senza finestra, vedere IOleInPlaceSiteWindowless .

Se l'oggetto restituisce sia il POINTERINACTIVE_ACTIVATEONENTRY che i valori POINTERINACTIVE_DEACTIVATEONLEAVE, l'oggetto viene attivato solo quando il mouse si trova sull'oggetto. Se il valore POINTERINACTIVE_ACTIVATEONENTRY viene impostato da solo, l'oggetto viene attivato una volta quando il mouse lo immette per la prima volta e rimane attivo.

Note ai chiamanti

I criteri di attivazione non devono essere memorizzati nella cache. Il contenitore deve chiamare questo metodo ogni volta che il mouse entra in un oggetto inattivo.

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

IOleInPlaceSiteWindowless

IPointerInactive