COleDropTarget::OnDragOver

Artykuł
06/10/2015

Wywołana przez ramy, gdy kursor zostanie przeciągnięty nad okno.

virtual DROPEFFECT OnDragOver( 
   CWnd* pWnd, 
   COleDataObject* pDataObject, 
   DWORD dwKeyState, 
   CPoint point  
);

Parametry

pWnd
Okno, w którym znajduje się kursor nad wskazuje.
pDataObject
Punkty do obiektu danych, zawierający dane, które ma być przerwane.
dwKeyState
Zawiera stan klawiszy modyfikujących.Jest to kombinacja dowolnej liczby następujących: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, i MK_RBUTTON.
point
Zawiera bieżącą lokalizację kursora w układzie współrzędnych klienta.

Wartość zwracana

Że spowodowałoby, że jeżeli próbowano spadek w lokalizacji określonej przez point.Mogą to być jeden lub więcej z następujących czynności:

DROPEFFECT_NONESpadek nie będzie dozwolona.
DROPEFFECT_COPYCzy wykonać operacji kopiowania.
DROPEFFECT_MOVECzy wykonać operacji przenoszenia.
DROPEFFECT_LINKUstanowiona zostanie łącze z porzuconych danych do oryginalnych danych.
DROPEFFECT_SCROLLWskazuje, że operacja przewijania przeciągnij może nastąpić, lub występuje w docelowej.

Uwagi

Ta funkcja powinna być pomijana umożliwiające operacji upuszczania w oknie.Domyślne tej funkcji wymaga CView::OnDragOver, który zwraca DROPEFFECT_NONE domyślnie.Ponieważ funkcja ta nazywa się często podczas operacji przeciągania i upuszczania, powinny być zoptymalizowane możliwie.

Aby uzyskać więcej informacji, zobacz IDropTarget::DragOver w Windows SDK.

Przykład

DROPEFFECT COleContainerView::OnDragOver(COleDataObject* pDataObject, 
   DWORD dwKeyState, CPoint point)
{
   UNREFERENCED_PARAMETER(pDataObject);
   UNREFERENCED_PARAMETER(point);

   DROPEFFECT de = DROPEFFECT_NONE;
   //Determine the type of operation 
   if((dwKeyState & MK_SHIFT) && (dwKeyState & MK_CONTROL))
      de = DROPEFFECT_LINK;
   else if(dwKeyState &  MK_CONTROL)
      de = DROPEFFECT_COPY;
   else if(dwKeyState & MK_SHIFT)
      de = DROPEFFECT_MOVE;
   return de;
}