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.
Retourner le code | Description |
---|---|
|
Handle non valide retourné dans le paramètre hwnd. |
|
La fenêtre spécifiée a déjà été inscrite en tant que cible de suppression. |
|
Mémoire insuffisante pour l’opération. |
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
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
plateforme cible | Windows |
d’en-tête | ole2.h |
bibliothèque | Ole32.lib |
DLL | Ole32.dll |