EvtDropEnter

Objekt betreten

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aDataObject: handle DragData -Objekt
aEffect: int erlaubte Effekte
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , EvtDropLeave , Ereignisbefehle , Ereignisabläufe Drag & Drop , Blog

Dieses Ereignis wird ausgelöst, wenn die Eigenschaft OleDropMode auf _WinOleDynamic gesetzt ist und das Objekt während einer Drag & Drop-Operation betreten wird. Beim Start der Drag & Drop-Operation wird das Ereignis ebenfalls ausgelöst.

Definition des Funktionskopfes:

sub EvtDropEnter
(
  aEvt                 : event;    // Ereignis
  aDataObject          : handle;   // Drag-Datenobjekt
  aEffect              : int;      // Rückgabe der erlaubten Effekte
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

aEvt

In diesem Parameter vom Typ event wird unter anderem der Deskriptor des auslösenden Objekts, d. h. das Objekt, in dem die Ereignisfunktion eingetragen wurde, übergeben.

aDataObject

In diesem Parameter wird der Deskriptor auf das DragData -Objekt übergeben. Das Objekt wird beim Starten der Drag & Drop-Operation mit Informationen gefüllt. Wird die Operation aus CONZEPT 16 heraus gestartet, werden die Daten im Ereignis EvtDragInit zur Verfügung gestellt.

aEffect

Hier werden die möglichen Drag & Drop-Operationen zurückgegeben. Folgende Konstanten können dazu verwendet werden:

_WinDropEffectNone: Drag & Drop-Operation nicht möglich
_WinDropEffectCopy: Daten dürfen kopiert werden
_WinDropEffectMove: Daten dürfen verschoben werden
_WinDropEffectLink: Daten dürfen verlinkt werden

Die Konstanten _WinDropEffectCopy, _WinDropEffectMove und _WinDropEffectLink können miteinander verknüpft werden. Wird eine Verschiebe-Operation durchgeführt, aber in dieser Variablen nur eine Kopieraktion zugelassen, wird dem Benutzer durch einen veränderten Mauszeiger darauf hingewiesen, das die Funktion nicht ausgeführt werden kann.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Beispiel:

sub EvtDropEnter
(
  aEvt                 : event;    // Ereignis
  aDataObject          : handle;   // Drag-Datenobjekt
  aEffect              : int;      // Rückgabe der erlaubten Effekte
)
: logic;                           // Wird nicht ausgewertet
{
  if (aDataObject->wpFormatEnum(_WinDropDataFile))
    aEffect # _WinDropEffectCopy | _WinDropEffectMove;
  else
    aEffect # _WinDropEffectNone;

  return(true);
}

EvtDropEnter​

EvtDropEnter