Show TOC

Ereignisse der Office-Anwendung verarbeitenLocate this document in the navigation structure

Verwendung

Sie können Ereignisse, die von der Office-Anwendung oder vom Benutzer der Office-Anwendung ausgelöst wurden, in Ihrem ABAP-Programm interpretieren und darauf eingehen. Es gibt folgende Ereignisse:

  • on_custom_event : Ereignis, das vom Benutzer der Office-Anwendung ausgelöst wurde. Diese Ereignisse werden durch Macroaufrufe ausgelöst.

  • on_close_event : Dieses Ereignis tritt ein, wenn das zu bearbeitende Dokument in der Office-Anwendung geschlossen wird. Sie haben dadurch die Möglichkeit,das Dokument noch zu sichern.

Prozess
  1. Melden Sie die Ereignisse an, die Sie in Ihrem Programm interpretieren wollen. Dies realisieren Sie beim Methodenaufruf init_control auf die Instanz control.

  2. Legen Sie die Verarbeitungslogik für angemeldete Ereignisse in einer eigenen Klasse an. Sie können dabei Klassenmethoden oder Objektmethoden verwenden.

  3. Definieren Sie - nachdem Sie das Dokument initialisiert haben (Methode get_document_proxy ) - die Ereignisbehandlung. Dabei können Sie mit statischen Methoden und Objektmethoden auf Ereignisse reagieren:

    • Statische Methoden

      SET HANDLER c_event_handler=>close_event FOR document.
      SET HANDLER c_event_handler=>custom_event FOR document.
                           
    • Objektmethoden

      DATA o_event_handler TYPE REF TO class_event_handler.
      CREATE OBJECT o_event_handler.
      SET HANDLER o_event_handler->close_event FOR document.
      SET HANDLER o_event_handler->custom_event FOR document.
                           
  4. Fügen Sie in jedes PAI-Modul Ihres Programms, das durchlaufen werden kann, solange die Desktop-Anwendung aktiv ist, den Methodenaufruf für die Ereignisbehandlung des Control Frameworks ein:

    CALL METHOD cl_gui_cfw=>dispatch
    IMPORTING return_code = return_code.