Funzione RegisterDragDrop (ole2.h)

Registra la finestra specificata come destinazione di un'operazione di trascinamento della selezione OLE e specifica l'istanza di IDropTarget da usare per le operazioni di rilascio.

Sintassi

HRESULT RegisterDragDrop(
  [in] HWND         hwnd,
  [in] LPDROPTARGET pDropTarget
);

Parametri

[in] hwnd

Handle in una finestra che può essere una destinazione per un'operazione di trascinamento della selezione OLE.

[in] pDropTarget

Puntatore all'interfaccia IDropTarget sull'oggetto che deve essere la destinazione di un'operazione di trascinamento della selezione in una finestra specificata. Questa interfaccia viene usata per comunicare le informazioni di trascinamento della selezione OLE per tale finestra.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Osservazioni

Se l'applicazione può accettare oggetti eliminati durante le operazioni di trascinamento della selezione OLE, è necessario chiamare la funzione RegisterDragDrop. Eseguire questa operazione ogni volta che una delle finestre dell'applicazione è disponibile come destinazione potenziale di rilascio; ovvero, quando la finestra viene visualizzata senza stub sullo schermo.

Il thread dell'applicazione che chiama la funzione RegisterDragDrop deve eseguire il pumping dei messaggi, presumibilmente chiamando la funzione GetMessage con un parametro NULLhWnd, perché OLE crea finestre sul thread che richiedono messaggi elaborati. Se questo requisito non viene soddisfatto, qualsiasi applicazione che trascina un oggetto sulla finestra registrata come destinazione di rilascio si blocca fino alla chiusura dell'applicazione di destinazione.

La funzione RegisterDragDrop registra solo una finestra alla volta, quindi è necessario chiamarla per ogni finestra dell'applicazione in grado di accettare oggetti eliminati.

Quando il mouse passa su parti non curate della finestra di destinazione durante un'operazione di trascinamento della selezione OLE, la funzione DoDragDrop chiama il metodo IDropTarget::D rag Over specificato per la finestra corrente. Quando un'operazione di rilascio si verifica effettivamente in una determinata finestra, la funzione DoDragDrop chiama IDropTarget::D rop.

La funzione RegisterDragDrop chiama anche il metodo IUnknown::AddRef sul puntatore IDropTarget .

Fabbisogno

Vedere anche

RevokeDragDrop