COleDataSource::DoDragDrop

Article
03/04/2013

Appelez la fonction membre d' DoDragDrop pour exécuter une opération de glisser-déplacer pour cette source de données, en général dans un gestionnaire de CWnd::OnLButtonDown .

DROPEFFECT DoDragDrop(
   DWORD dwEffects = DROPEFFECT_COPY|DROPEFFECT_MOVE|DROPEFFECT_LINK,
   LPCRECT lpRectStartDrag = NULL,
   COleDropSource* pDropSource = NULL 
);

Paramètres

dwEffects
Opérations de glisser-déplacer qui sont autorisées sur cette source de données.Peut être un ou plusieurs des éléments suivants :
- l'opération de copie d'DROPEFFECT_COPY A pu être exécutée.
- l'opération de déplacement d'DROPEFFECT_MOVE A pu être exécutée.
- Le lien d'DROPEFFECT_LINK A des données déplacées aux données d'origine a pu être généré.
- DROPEFFECT_SCROLL indique qu'une opération de défilement de glisser-déplacer peut se produire.
lpRectStartDrag
Pointeur vers le rectangle qui définit où l'opération glisser commence réellement.Pour plus d'informations, consultez la section Notes qui suit.
pDropSource
Pointe vers une source de déplacement.Si NULL ensuite une implémentation par défaut de COleDropSource sera utilisé.

Valeur de retour

Effet de déplacement généré par l'opération de glisser-déplacer ; sinon DROPEFFECT_NONE si l'opération n'est jamais parce que l'utilisateur a libéré le bouton de la souris avant de quitter le rectangle fourni.

Notes

L'opération de glisser-déplacer ne démarre pas immédiatement.Elle attend que le curseur de la souris quitte le rectangle spécifié par lpRectStartDrag ou jusqu'à ce qu'un nombre de millisecondes sont passés.Si lpRectStartDrag est NULL, la taille du rectangle est un pixel.

Le délai est spécifié par un paramètre de clé de Registre.Vous pouvez modifier le délai en appelant CWinApp::WriteProfileString ou CWinApp::WriteProfileInt.Si vous ne spécifiez pas le délai, une valeur par défaut de 200 millisecondes est utilisée.Le délai de glisser-déplacer est stocké comme suit :

Le délai de glisser-déplacer Windows NT est stocké dans HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\Windows\NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay.
Le délai de glisser-déplacer windows 3.x est stocké dans le fichier de WIN.INI, sous la section [fenêtres}.
Le délai de glisser-déplacer de Windows 95/98 est stocké dans une version mise en cache de WIN.INI.

Pour plus d'informations sur la façon dont les informations de délai de glisser-déplacer sont stockées dans le Registre ou le fichier .ini, consultez WriteProfileString dans Kit de développement logiciel Windows.

Pour plus d'informations, consultez l'article glisser-déplacer : implémenter une source de déplacement.