IDropTarget::D rop, méthode (oleidl.h)

Article
08/25/2023

Incorpore les données sources dans la fenêtre cible, supprime les commentaires cibles et libère l’objet de données.

Syntaxe

HRESULT Drop(
  [in]      IDataObject *pDataObj,
  [in]      DWORD       grfKeyState,
  [in]      POINTL      pt,
  [in, out] DWORD       *pdwEffect
);

Paramètres

[in] pDataObj

Pointeur vers l’interface IDataObject sur l’objet de données transféré dans l’opération glisser-déplacer.

[in] grfKeyState

État actuel des touches de modificateur du clavier sur le clavier. Les valeurs possibles peuvent être une combinaison des indicateurs MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON et MK_RBUTTON.

[in] pt

Structure POINTL contenant les coordonnées actuelles du curseur dans les coordonnées de l’écran.

[in, out] pdwEffect

En entrée, pointeur vers la valeur du paramètre pdwEffect de la fonction DoDragDrop . Au retour, doit contenir l’un des indicateurs DROPEFFECT , qui indique le résultat de l’opération de suppression.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour	Description
E_UNEXPECTED	Une erreur inattendue s’est produite.
E_INVALIDARG	Le paramètre pdwEffect n’est pas valide.
E_OUTOFMEMORY	La mémoire disponible pour cette opération est insuffisante.

Notes

Vous n'appelez pas cette méthode directement. La fonction DoDragDrop appelle cette méthode lorsque l’utilisateur termine l’opération de glisser-déplacer.

Lors de l’implémentation de Drop, vous devez incorporer l’objet de données dans la cible. Utilisez les formats disponibles dans IDataObject, disponibles via pDataObj, ainsi que l’état actuel des clés modificateurs pour déterminer la façon dont les données doivent être incorporées, par exemple la liaison ou l’incorporation.

En plus d’incorporer les données, vous devez également propre comme vous le faites dans la méthode IDropTarget::D ragLeave :

Supprimez les commentaires cibles actuellement affichés.
Libérez toutes les références à l’objet de données.

Vous transmettez également l’effet de cette opération à l’application source via DoDragDrop, afin que l’application source puisse propre une fois l’opération de glisser-déplacer terminée :

Supprimez tout commentaire source affiché.
Apportez les modifications nécessaires aux données, telles que la suppression des données si l’opération était un déplacement.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleidl.h