Ereignisse bei Drag&Drop (SAP-Bibliothek - Schlüsselbereiche von SAP NetWeaver)

Ereignisse bei Drag&Drop

Im folgenden Abschnitt werden nur die allgemeingültigen Eigenschaften der Ereignisse bei Drag&Drop beschrieben. Diese können von den einzelnen Control-Verschalungen angereichert werden. Daher sollten Sie auf jeden Fall auch in der Dokumentation zur jeweiligen Control-Verschalung die Besonderheiten des Controls nachlesen.

Verwendung

Im Umfeld des Drag&Drop gibt es vier Standardereignisse, bei denen Sie die Kontrolle in Ihrem Applikationsprogramm bekommen können. In den Behandlerroutinen zu diesen Ereignissen implementieren Sie, welche Aktionen bei einem Drag&Drop-Vorgang durchgeführt werden.

Hinweis

Bestimmte Control-Verschalungen können zusätzliche Drag&Drop-Ereignisse anbieten. Hinweise dazu finden Sie in der jeweiligen Dokumentation.

Voraussetzungen

Um auf die Ereignisse reagieren zu können, müssen Sie sich auf sie registrieren. Im Gegensatz zu der normalen Ereignisbehandlung werden aber die Ereignisse nicht mit der Methode set_registered_events am Control Framework angemeldet. Die Registrierung erfolgt automatisch über die Verschalung des eingesetzten Custom Controls.

Sie müssen aber weiterhin Behandlermethoden für die Ereignisse angeben:

DATA tree TYPE REF TO cl_gui_simple_tree.
SET HANDLER dragdrop=>on_drag FOR tree.

Die Ereignisse werden immer als Systemereignisse angemeldet.

Funktionsumfang

Das Control Framework reicht beim Drag&Drop erst zum Drop-Zeitpunkt ein Ereignis an den Applikationsserver weiter. Dieses wird dann am Applikationsserver, wie in Ablauf einer Drag&Drop-Operation beschrieben, innerhalb eines Drag&Drop-Vorgangs in maximal vier Standardereignisse auseinandergesteuert. Alle Ereignisse haben ein Drag&Drop-Datenobjekt als Ereignisparameter. Über diesen Parameter müssen Sie den Kontext des Drag&Drop-Vorgangs verwalten. Weiterhin übergibt Ihnen die jeweilige Control-Verschalung weitere Informationen zu dem Drag&Drop-Kontext. Lesen Sie dazu die Dokumentation der Control-Verschalung.

ONGETFLAVOR : Dieses Ereignis wird nur dann ausgelöst, wenn das Quellobjekt und das Zielobjekt über mehrere gemeinsame Flavors verfügen. Sie müssen dann in der Behandlermethode einen der gemeinsamen Flavors auswählen. Wenden Sie dazu die Methode set_flavor auf das Drag&Drop-Datenobjekt an.
Das Ereignis wird von dem Zielobjekt des Drag&Drop-Vorgangs ausgelöst.

ONDRAG : Dieses Ereignis wird immer dann ausgelöst, wenn der Drag&Drop-Vorgang am Frontend beendet ist. In diesem Ereignis müssen Sie den Kontext des Quellobjekts bestimmen. Diesen Kontext übergeben Sie dann an die als Ereignisparameter übergebene Instanz der Klasse CL_DRAGDROPOBJECT .
Das Ereignis wird von dem Quellobjekt des Drag&Drop-Vorgangs ausgelöst.

ONDROP : Zu diesem Ereignis definieren Sie die Aktionen, die im Zielobjekt durchgeführt werden sollen. Dabei nutzen Sie den Ereignisparameter für den Kontext, den Sie zum Ereignis ONDRAG gefüllt haben. Bei diesem Ereignis ist folgendes zu beachten:

Innerhalb des ONDROP-Ereignisses muß ein dynamischer TypeCast durchgeführt werden. Die mögliche Ausnahme des TypeCast muß auf jeden Fall abgefangen werden. Falls ein nicht passendes Objekt zugewiesen werden sollte, muß in der Ausnahmebehandlung die Drag&Drop-Verarbeitung mit der Methode abort abgebrochen werden.

Die verwendeten Flavors sollten so gewählt werden, daß eine Zuordnung des Drag&Drop-Objekts zu dem richtigen TypeCast möglich ist.

Das Ereignis wird von dem Zielobjekt des Drag&Drop-Vorgangs ausgelöst.

ONDROPCOMPLETE : Sofern Sie zum Abschluß des Drag&Drop-Vorgangs noch weitere Aktionen durchführen wollen, können Sie dies in diesem Ereignis realisieren. Dies ist z.B. im Falle einer Verschiebeoperation sinnvoll.
Das Ereignis wird von dem Quellobjekt des Drag&Drop-Vorgangs ausgelöst.