ajanzen.com Einfache ALV-Anzeige mit Doppelklick- Funktion

Transkript

1 ajanzen.com Einfache ALV-Anzeige mit Doppelklick- Funktion

2 ajanzen.com 1 Einleitung Der Fokus des vorliegenden Dokumentes liegt auf dem Aktivieren der Doppelklick- Funktion bei Verwendung von Klasse CL_SALV_TABLE. Im Rahmen dessen wird auch auf die Behandlung des Ereignisses DOUBLE_CLICK eingegangen. Zur besseren Strukturierung des Codes ist die Ereignisbehandlung in ein eigenständiges INCLUDE ausgelagert. Die im vorliegenden Beispiel ausgeprägte Funktion zur Ereignisbehandlung ist relativ einfach und visualisiert ausschließlich den Inhalt der geklickten Zelle und den zugehörigen Zeilenindex über die MESSAGE-Anweisung. Das komplette Beispielcoding ist in Kapitel 3 enthalten. Nähere Informationen zum Ablauf können Kapitel 2 entnommen werden. 1

3 ajanzen.com 2 Informationen zur Programmlogik Im vorliegenden Beispiel werden vorbereitend die Informationen aus Tabelle SFLIGHT in eine interne Tabelle zur Anzeige im ALV selektiert. Anschließend wird gezeigt, wie die ALV-Anzeige um eine Doppelklick-Funktion erweitert werden kann. Das visuelle Ergebnis ist eine einfache ALV-Anzeige. Die implementierte Funktion kann per Doppelklick auf jede beliebige Zelle des ALVs ausgeführt werden. Aus Gründen der Übersichtlichkeit sind Hauptprogramm und das INCLUDE zur Ereignisbehandlung in eigenständigen Kapiteln enthalten. 2.1 Hauptprogramm Im ersten Schritt des ALV-Aufrufes wird über die FACTORY-Methode der Klasse CL_SALV_TABLE eine Instanz derselben Klasse erzeugt. Dabei wird der Factory- Methode die Tabelle mit den anzuzeigenden Informationen direkt mitgegeben. Eine zusätzliche Angabe eines Feldkataloges ist nicht notwendig, da sich die CL_SALV_TABLE-Klasse die Dictionary-Informationen anhand der Tabellenfelder ermittelt. Über eine Instanz von Klasse CL_SALV_COLUMNS_TABLE wird die Spaltenbreite an den Inhalt angepasst (optimiert). Zum besseren Markieren der einzelnen Zeilen, erfolgt das Aktivieren des Selektionsmodus. Für diese Aktivität wird zum ALV eine Instanz der Klasse CL_SALV_SELECTIONS erzeugt und der Selektionsmodus durch Aufruf von Methode SET_SELECTION_MODE( ) gesetzt. Für das Aktivieren der Toolbar mit den ALV-Standardfunktionen, ist eine Instanz der Klasse CL_SALV_FUNCTIONS_LIST zum ALV notwendig. Das eigentliche Aktivieren erfolgt über Methode SET_ALL( ) der soeben erzeugten Instanz. Wie bereits einleitend erwähnt, wird beim Doppelklick ein Ereignis ausgelöst. Die Ereignisbehandlung findet über eine eigenständige lokale Klasse statt. Nähere Informationen zu der Klasse können Kapitel 2.2 entnommen werden. Damit das ALV weiß, wo das Klick-Ereignis behandelt wird, ist eine Verbindung zwischen Ereignis und Ereignis-Behandler herzustellen, also das Ereignis zu registrieren. Zum Registrieren wird eine Instanz der Klasse CL_SALV_EVENTS_ TABLE benötigt. Das Objekt der Klasse verwaltet die SALV-Ereignisse. 2

4 ajanzen.com Da zur Ereignisbehandlung eine eigenständige Klasse zum Einsatz kommt, muss diese ebenfalls instanziiert werden. Nach Instanziieren der lokalen Behandler-Klasse wird diese über die Anweisung SET HANDLER der Instanz von CL_SALV_EVENTS_ TABLE zugeordnet und damit die Verbindung zwischen Ereignis und Ereignisbehandlung hergestellt. Hinweis: Bei dem ausgelösten Ereignis handelt es sich um DOUBLE_CLICK. Dieses kann der Registerkarte Ereignisse der Klasse CL_SALV_EVENTS_TABLE entnommen werden (siehe Abbildung 1). In der Behandler-Klasse kommt für die Ereignisbehandlung Methode HANDLE_DOUBLE_CLICK zum Einsatz. Abbildung 1: Ereignis ADDED_FUNCTION der Klasse CL_SALV_EVENTS_TABLE Das eigentliche Anzeigen des ALV erfolgt über Methode DISPLAY( ) der ALV-Klasse. Da beim Aufruf der FACTORY-Methode kein Container mitgegeben wurde, kümmert sich die ALV-Klasse selbständig um einen Dynpro-Aufruf. 2.2 INCLUDE zur Ereignisbehandlung Wie bereits im Vorfeld beschrieben, ist für die Behandlung des Ereignisses Double- Click eine Behandler-Klasse notwendig. In dem vorliegenden Beispiel wurde die Klasse in ein eigenständiges INCLUDE ausgelagert. Die ausgeprägte Logik ist in Kapitel 2.2 beschrieben. Die Behandler-Klasse besteht neben der Constructor-Methode ausschließlich aus Methode HANDLE_DOUBLE_CLICK. Letztere wurde als Event-handler für das Ereignis DOUBLE_CLICK der Klasse CL_SALV_EVENTS_TABLE definiert. Beim Instanziieren der Behandler-Klasse werden der Constructor-Methode eine Instanz der SALV-Klasse und die Tabelle mit den Daten übergeben. Der Inhalt beider Parameter wird in klassenglobalen Attributen abgelegt und damit für die Weiterverarbeitung vorgehalten. Bei Ablage der Datentabelle ist zu beachten, dass 3

5 ajanzen.com diese nicht über ein = sondern über die Anweisung GET REFERENCE OF erfolgt. Siehe nachfolgende Erklärung: Bei Verwenden des = für die Datenzuweisung wird der Inhalt der Importparameter- Tabelle IT_SFLIGHT in das globale Klassenattribut kopiert. Dadurch existieren die Informationen (Tabellen) doppelt (siehe Abbildung 2). Importparameter IT_SFLIGHT Mandant Carrier Flug-Nr. Flugdatum Flugpreis 001 AA , AA , AZ , AZ , AZ ,00 Globales Attribut GT_SFLIGHT_CLASS Mandant Carrier Flug-Nr. Flugdatum Flugpreis 001 AA , AA , AZ , AZ , AZ ,00 Abbildung 2: Doppeln der Daten bei Zuweisung über = Bei Verwendung der Anweisung GET REFERENCE OF wird ein Zeiger auf die übergebenen Daten erzeugt. Dadurch sind die Informationen nur einmal vorhanden und alle Änderungen (z.b. sortieren der Tabelle im ALV) sind ohne weiteren Aufwand ersichtlich (siehe Abbildung 3). Importparameter IT_SFLIGHT Mandant Carrier Flug-Nr. Flugdatum Flugpreis 001 AA , AA , AZ , AZ , AZ ,00 Globales Attribut GT_SFLIGHT_CLASS Abbildung 3: Zeiger auf Ursprungsdaten bei der Zuweisung GET REFERENCE OF Hinweis: In der FACTORY-Methode der SALV-Klasse wird ebenfalls nur eine Referenz auf die übergebenen Daten erzeugt. Die eigentliche Verarbeitungslogik von Methode HANDLE_DOUBLE_CLICK ist relativ simpel. Unter Verwendung von Parameter ROW wird die doppelt geklickte Zeile bestimmt. Das geklickte Feld ist im Parameter COLUMN enthalten. Der Feldinhalt kann über die ASSIGN-Anweisung in ein Feldsymbol übernommen werden. Die Informationen zur geklickten Zeile und zum Feldinhalt werden verkettet und anschließend über die MESSAGE-Anweisung visualisiert. 4

6 3 Coding Wie aus der Überschrift ersichtlich ist, enthält Kapitel 3 das komplette Beispielcoding. Genau wie beim Aufbau von Kapitel 2 sind Hauptprogramm und das INCLUDE zur Ereignisbehandlung in eigenständigen Unterkapiteln enthalten. 3.1 Hauptprogramm * * * Das vorliegende Programm dient der Demonstration eines SALV mit der * Reaktion auf Doppelklicks * * Date: * * * Änderungen * * REPORT zaj_sel_mode_dbl_click_salv. * Include zur Ereignisbehandlung INCLUDE zaj_sel_mode_dbl_click_salv_cl. DATA: gr_salv DATA: gr_columns DATA: gr_functions DATA: gr_selections DATA: gt_sflight DATA: gr_err_salv DATA: gv_string DATA: gr_events DATA: gr_event_handler TYPE REF TO cl_salv_table. TYPE REF TO cl_salv_columns_table. TYPE REF TO cl_salv_functions_list. TYPE REF TO cl_salv_selections. TYPE flighttab. TYPE REF TO cx_salv_msg. TYPE string. TYPE REF TO cl_salv_events_table. TYPE REF TO gcl_event_handler. START-OF-SELECTION. * Selektion der anzuzeigenden Daten

7 SELECT * FROM sflight INTO CORRESPONDING FIELDS OF TABLE gt_sflight. IF sy-subrc NE 0. * In diesem Fall wird eine leere Tabelle angezeigt ENDIF. * Daten anzeigen TRY. * ALV-Instanz erzeugen CALL METHOD cl_salv_table=>factory EXPORTING list_display = if_salv_c_bool_sap=>false r_container = cl_gui_custom_container=>default_screen IMPORTING r_salv_table = gr_salv CHANGING t_table = gt_sflight. CATCH cx_salv_msg INTO gr_err_salv. * Fehler anzeigen gv_string = gr_err_salv->get_text( ). MESSAGE gv_string TYPE 'E'. ENDTRY. * Instanz für Spalten holen gr_columns = gr_salv->get_columns( ). * Spaltenbreite optimieren gr_columns->set_optimize( abap_true ). " nur ein 'X' * Selection-Mode aktivieren * Instanz des Selection-Objektes holen

8 gr_selections = gr_salv->get_selections( ). * Selektionsmodus setzen gr_selections->set_selection_mode( if_salv_c_selection_mode=>row_column ). * Alle Standard-Funktionen auf aktiv setzen * Instanz für Funktionen holen gr_functions = gr_salv->get_functions( ). * Alle Standardfunktionen aktivieren gr_functions->set_all( abap_true ). " nur ein 'X' * Ereignis zum Behandeln des Button-Click registrieren * Das Objekt für die möglichen ALV-Ereignisse holen gr_events = gr_salv->get_event( ). * Objekt für die Ereignisbehandlung erzeugen... CREATE OBJECT gr_event_handler EXPORTING cr_salv = gr_salv it_sflight = gt_sflight. *... und bei den ALV-Ereignissen registrieren SET HANDLER gr_event_handler->handle_double_click FOR gr_events. * ALV-Anzeige anstoßen * ALV-Anzeige anstoßen gr_salv->display( ). * "Trägerbildschirm" für Container rufen WRITE space.

9 3.2 INCLUDE zur Ereignisbehandlung *& * *& Include ZAJ_SEL_MODE_DBL_CLICK_SALV_CL *& * * Definition der Klasse CLASS gcl_event_handler DEFINITION. PUBLIC SECTION. METHODS: constructor IMPORTING cr_salv TYPE REF TO cl_salv_table it_sflight TYPE flighttab. METHODS: handle_double_click FOR EVENT double_click OF cl_salv_events_table IMPORTING row column. PROTECTED SECTION. DATA: gr_salv_class TYPE REF TO cl_salv_table. DATA: gt_sflight_class TYPE REF TO flighttab. ENDCLASS. "gcl_event_handler DEFINITION * Implementierung der Klasse CLASS gcl_event_handler IMPLEMENTATION. METHOD constructor. * Importparameter in globale Klassenattribute übernehmen gr_salv_class = cr_salv. GET REFERENCE OF it_sflight INTO gt_sflight_class. ENDMETHOD. "constructor

10 METHOD handle_double_click. CONSTANTS: lc_zero DATA: ls_flight DATA: lv_message DATA: lv_row_char DATA: lv_value_chart FIELD-SYMBOLS: <lv_any_value> TYPE char1 VALUE '0'. TYPE sflight. TYPE char250. TYPE char10. TYPE char50. TYPE any. * Informationen zur geklickten Zeile lesen READ TABLE gt_sflight_class->* INTO ls_flight INDEX row. CHECK sy-subrc EQ 0. * Wert in Feldsymbol übernehmen0 ASSIGN COMPONENT column OF STRUCTURE ls_flight TO <lv_any_value>. CHECK sy-subrc EQ 0. * Zeilenindes für die Ausgabe in lesbarere Form übernehmen MOVE row TO lv_row_char. SHIFT lv_row_char LEFT DELETING LEADING lc_zero. SHIFT lv_row_char LEFT DELETING LEADING space. * Inhalt als Character übernehmen, da sonst eine Konvertierung * nicht immer möglich ist (so z.b. bei Zahlen) MOVE <lv_any_value> TO lv_value_chart. SHIFT lv_value_chart LEFT DELETING LEADING lc_zero. SHIFT lv_value_chart LEFT DELETING LEADING space. * Nachricht vorbereiten... auf eine Konvertierung des * Feldinhaltes wurde hier verzichtet CONCATENATE: 'Sie haben Wert' lv_value_chart 'in Zeile' lv_row_char 'selektiert' INTO lv_message SEPARATED BY space.

11 * Nachricht anzeigen MESSAGE lv_message TYPE 'I'. ENDMETHOD. "handle_toolbar_click ENDCLASS. "gcl_event_handler IMPLEMENTATION