RegisterDragDrop, fonction (ole2.h)

Inscrit la fenêtre spécifiée en tant que cible d’une opération de glisser-déplacer OLE et spécifie l’instance IDropTarget à utiliser pour les opérations de déplacement.

Syntaxe

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

Paramètres

[in] hwnd

Gérez vers une fenêtre qui peut être une cible pour une opération de glisser-déplacer OLE.

[in] pDropTarget

Pointeur vers l’interface IDropTarget sur l’objet qui doit être la cible d’une opération de glisser-déplacer dans une fenêtre spécifiée. Cette interface est utilisée pour communiquer les informations de glisser-déplacer OLE pour cette fenêtre.

Valeur de retour

Cette fonction retourne S_OK sur la réussite. Les autres valeurs possibles sont les suivantes.

Remarques

Si votre application peut accepter des objets supprimés pendant les opérations de glisser-déplacer OLE, vous devez appeler la fonction RegisterDragDrop. Effectuez cette opération chaque fois que l’une de vos fenêtres d’application est disponible en tant que cible de suppression potentielle ; autrement dit, lorsque la fenêtre apparaît non visible à l’écran.

Le thread d’application qui appelle la fonction RegisterDragDrop doit être de pomper des messages, probablement en appelant la fonction GetMessage avec un paramètre NULLhWnd, car OLE crée des fenêtres sur le thread qui a besoin de messages traités. Si cette exigence n’est pas remplie, toute application qui fait glisser un objet sur la fenêtre inscrite en tant que cible de déplacement se bloque jusqu’à ce que l’application cible se ferme.

La fonction RegisterDragDrop enregistre une seule fenêtre à la fois. Vous devez donc l’appeler pour chaque fenêtre d’application capable d’accepter des objets supprimés.

Lorsque la souris passe sur des parties non observées de la fenêtre cible pendant une opération de glisser-déplacer OLE, la fonction DoDragDrop appelle la méthode IDropTarget ::D ragOver spécifiée pour la fenêtre active. Lorsqu’une opération de suppression se produit réellement dans une fenêtre donnée, la fonction DoDragDrop appelle IDropTarget ::D rop.

La fonction RegisterDragDrop appelle également la méthode IUnknown ::AddRef sur le pointeur IDropTarget .

Exigences

Voir aussi

RevokeDragDrop