Partager via


COleServerItem::DoDragDrop

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

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

Paramètres

  • lpRectItem
    Le rectangle de l'élément sur l'écran, en pixels, par rapport à la zone cliente.

  • 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 des données de liens sont copiées dans le presse-papiers.Placez -le à FALSE si votre application n'est pas en charge.

  • dwEffects
    Détermine les effets que la source de glissement autorisera dans l'opération glisser (une combinaison de copier, déplacer, et de liens).

  • 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 d'énumération 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, un rectangle par défaut est utilisé afin que le glisser-déplacer démarre lorsque le curseur de la souris se déplace 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

Classe de COleServerItem

Graphique de la hiérarchie

COleDataSource::DoDragDrop

COleServerItem::CopyToClipboard