Condividi tramite


COleServerItem::DoDragDrop

Chiamare la funzione membro DoDragDrop per eseguire un'operazione di trascinamento della selezione.

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

Parametri

  • lpRectItem
    Il rettangolo dell'elemento sullo schermo, in pixel, relativo all'area client.

  • ptOffset
    L'offset da lpItemRect in cui la posizione del mouse è al momento del trascinamento.

  • bIncludeLink
    Impostare questo parametro su TRUE se i dati di collegamento vengono copiati negli Appunti.Impostarla su FALSE se l'applicazione non fa collegamenti di supporto.

  • dwEffects
    Determina gli effetti che l'origine di trascinamento consente dell'operazione di trascinamento (una combinazione di copiare, spostare e di collegamento).

  • lpRectStartDrag
    Puntatore al rettangolo che definisce dove il trascinamento in realtà viene avviato.Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Valore ottenuto dall'enumerazione DROPEFFECT.Se è DROPEFFECT_MOVE, i dati originali devono essere rimossi.

Note

L'operazione di trascinamento della selezione non avvia immediatamente.Attende finché il cursore del mouse non lasciare il rettangolo specificato da lpRectStartDrag o finché il numero di millisecondi specificato non venga passato.Se lpRectStartDrag è NULL, un rettangolo predefinito viene utilizzato in modo che il trascinamento si avvia quando il cursore del mouse si sposta un pixel.

Il ritardo è specificato da un'impostazione della chiave del Registro di sistema.È possibile modificare il ritardo chiamando CWinApp::WriteProfileString o CWinApp::WriteProfileInt.Se non si specifica il ritardo, un valore predefinito di 200 millisecondi viene utilizzato.Il ritardo di trascinamento è archiviato come segue:

  • Il ritardo di trascinamento in Windows NT viene archiviato in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\\Windows NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay.

  • Il ritardo del trascinamento di Windows 3.x viene memorizzato nel file di WIN.INI, sotto la sezione [di Windows}.

  • Il ritardo di trascinamento in Windows 95/98 memorizzato in una versione memorizzata nella cache di WIN.INI.

Per ulteriori informazioni su come le informazioni di ritardo di trascinamento vengono archiviate nel Registro di sistema o nel file di .INI, vedere WriteProfileString in Windows SDK.

Requisiti

Header: afxole.h

Vedere anche

Riferimenti

Classe di COleServerItem

Grafico della gerarchia

COleDataSource::DoDragDrop

COleServerItem::CopyToClipboard