Partager via


COleClientItem::DoDragDrop

Appelez la fonction membre d' DoDragDrop pour exécuter une opération de glisser-déplacer.

DROPEFFECT DoDragDrop( 
   LPCRECT lpItemRect, 
   CPoint ptOffset, 
   BOOL bIncludeLink = FALSE, 
   DWORD dwEffects = DROPEFFECT_COPY | DROPEFFECT_MOVE, 
   LPCRECT lpRectStartDrag = NULL  
);

Paramètres

  • lpItemRect
    Le rectangle de l'élément à l'écran dans les coordonnées clientes (pixels).

  • ptOffset
    L'offset d' lpItemRect où la position de la souris est au moment de le glisser-déplacer.

  • bIncludeLink
    Définissez ce paramètre à TRUE si les données de liens sont copiées dans le presse-papiers. Placez -le à FALSE si votre application serveur ne fait pas en charge.

  • dwEffects
    Détermine les effets que la source de glissement autorisera dans l'opération glisser.

  • 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.

Valeur de retour

Valeur DROPEFFECT. Si c'est DROPEFFECT_MOVE, les données d'origine doivent être supprimées.

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.

Configuration requise

Header: afxole.h

Voir aussi

Référence

COleClientItem, classe

Graphique de la hiérarchie

COleDataSource::DoDragDrop

COleClientItem::CopyToClipboard