Metodo IDirectManipulationViewport::SetContact (directmanipulation.h)

Specifica un'associazione tra un contatto e il viewport.

Sintassi

HRESULT SetContact(
  [in] UINT32 pointerId
);

Parametri

[in] pointerId

ID del puntatore.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Chiamare questo metodo quando viene ricevuto un messaggio di WM_POINTERDOWN . Quando si riceve un WM_POINTERDOWN, l'applicazione può usare le coordinate dell'input per eseguire il hit test e determinare i viewport a cui è associato il contatto.

DeferContact deve essere chiamato prima di SetContact.

Dopo l'inizializzazione, la manipolazione diretta non riconosce le relazioni tra viewport z order o padre-figlio. L'ordine delle chiamate SetContact definisce l'albero del riquadro di visualizzazione. Per stabilire la gerarchia del riquadro di visualizzazione corretta, SetContact deve essere chiamato per primo nel viewport più figlio, seguito dall'elemento padre, padre padre e così via.

Usare GET_POINTERID_WPARAM per ottenere l'identificatore del puntatore da un messaggio puntatore. Il contatto viene rimosso automaticamente quando viene ricevuto WM_POINTERUP .

Se un contatto è associato a uno o più viewport utilizzando il metodo SetContact , La manipolazione diretta esaminerà ulteriormente l'input del contatto e tenterà di identificare una manipolazione appropriata in base alla configurazione dei viewport associati. Se viene riconosciuta una manipolazione, l'applicazione riceverà un messaggio di WM_POINTERCAPTURECHANGED per questo contatto. In questo contesto, il messaggio WM_POINTERCAPTURECHANGED indica che la manipolazione diretta ha acquisito il contatto e l'applicazione non riceverà l'input da questo contatto utilizzato per questa manipolazione.

Requisiti

Vedi anche

IDirectManipulationViewport

Messaggi e notifiche di input dell'utente