Ansicht
Dokumentation
ABAPAT_SELECTION-SCREEN_EVENTS - AT SELECTION-SCREEN EVENTS
CL_GUI_FRONTEND_SERVICES - Frontend Services Vendor Master (General Section)Diese Dokumentation steht unter dem Copyright der SAP AG.
AT SELECTION-SCREEN, selscreen_event
... ${ OUTPUT $}
$| ${ ON ${para$|selcrit$} $}
$| ${ ON END OF selcrit $}
$| ${ ON BLOCK block $}
$| ${ ON RADIOBUTTON GROUP group $}
$| ${ $}
$| ${ ON ${HELP-REQUEST$|VALUE-REQUEST$}
FOR ${para$|selcrit-low$|selcrit-high$} $}
$| ${ ON EXIT-COMMAND $}.
Alternativen:
1. ... OUTPUT
2. ... ON ${para$|selcrit$}
3. ... ON END OF selcrit
4. ... ON BLOCK block
5. ... ON RADIOBUTTON GROUP group
6. ... ${ $}
7. ... ON ${HELP-REQUEST$|VALUE-REQUEST$} FOR ${para$|selcrit-low$|selcrit-high$}
8. ... ON EXIT-COMMAND
Wirkung
Diese Zusätze erlauben die Einzelauswertung spezifischer Elemente der
Selektionsbilder
des Programms. Die Information, welches Selektionsbild das Ereignis ausgelöst hat, steht im Systemfeld sy-dynnr zur Verfügung.
Alternative 1
... OUTPUT
Wirkung
Dieses Ereignis wird beim Dynpro-Ereignis PBO
eines Selektionsbildes ausgelöst. In dem Ereignisblock kann das Selektionsbild durch Zuweisungen
an die Datenobjekte von Parametern und Selektionskriterien und durch dynamische Bildschirmmodifikationen vorbereitet werden.
Hinweise
- Die Zuweisungen an Eingabefelder im Ereignisblock AT SELECTION-SCREEN OUTPUT wirken sich immer auf das Selektionsbild aus und überschreiben die Benutzereingaben von vorherigen Anzeigen des gleichen Selektionsbildes. Zuweisungen in den Ereignisblöcken LOAD-OF-PROGRAM oder INITIALIZATION wirken dagegen nur beim ersten Programmstart.
- Während dem Ereignis AT SELECTION-SCREEN OUTPUT kann die Anweisung MODIFY
SCREEN verwendet werden, um Eigenschaften von Bildschirmelementen des Selektionsbilds zu verändern.
Beispiel
Der folgende Abschnitt eines ausführbaren Programms modifiziert ein Eingabefeld eines Selektionsbildes,
das mit PARAMETERS deklariert wurde.
Die Eingabe in das Feld ist unsichtbar, d.h. durch die Zeichen "***..." überdeckt, was beispielsweise für die Eingabe eines Passworts verwendet werden kann.
Alternative 2
... ON ${para$|selcrit$}
Wirkung
Dieses Ereignis wird beim Dynpro-Ereignis PAI eines Selektionsbildes ausgelöst, wenn der Inhalt des Eingabefeldes eines Parameters para oder eine Zeile eines Selektionskriteriums selcrit an das ABAP-Programm übergeben wurde. In dem Ereignisblock kann die Benutzereingabe überprüft werden. Das Senden einer Warnung oder Fehlermeldung im Ereignisblock macht die Felder von para bzw. selcrit wieder eingabebereit.
Es kann kein Parameter angegeben werden, der als Auswahlknopf definiert ist. Für solche ist der Zusatz ON RADIOBUTTON GROUP vorgesehen.
Hinweis
Wenn im Dialogfenster für die Mehrfachselektion eines Selektionskriteriums selcrit eine Benutzeraktion stattfindet, werden die Einträge der
Selektionstabelle
Zeile für Zeile an das Programm übergeben, wobei für jede Zeile das Ereignis AT SELECTION-SCREEN ON selcrit ausgelöst wird.
Alternative 3
... ON END OF selcrit
Wirkung
Dieses Ereignis wird ausgelöst, nachdem nach einer Benutzeraktion im Dialogfenster für
die Mehrfachselektion die Selektionstabelle selcrit vollständig an das Programm übergeben wurde. Im Ereignisblock kann die gesamte Selektionstabelle überprüft werden.
Alternative 4
... ON BLOCK block
Wirkung
Dieses Ereignis wird beim Dynpro-Ereignis PAI eines Selektionsbildes ausgelöst, wenn alle Eingabefelder
eines Blocks block des Selektionsbildes an das ABAP-Programm übergeben wurden. In dem
Ereignisblock können die Benutzereingaben überprüft werden. Das Senden einer Warnung oder Fehlermeldung in dem Ereignisblock macht alle Felder des Blocks block wieder eingabebereit.
Block- und Auswahlknopfverarbeitung
Alternative 5
... ON RADIOBUTTON GROUP group
Wirkung
Dieses Ereignis wird beim Dynpro-Ereignis PAI
eines Selektionsbildes ausgelöst, wenn alle Felder einer Auswahlknopfgruppe group des
Selektionsbildes an das ABAP-Programm übergeben wurden. In dem Ereignisblock kann die Benutzereingabe überprüft werden. Das Senden einer
Warnung oder
Fehlermeldung im Ereignisblock macht alle Auswahlknöpfe der Gruppe group wieder eingabebereit.
Hinweis
Die einzelnen Felder einer Auswahlknopfgruppe werden nicht einzeln übergeben und lösen nicht das Ereignis AT SELECTION-SCREEN ON par aus.
Block- und Auswahlknopfverarbeitung
Alternative 6
... ${ $}
Wirkung
Das Ereignis AT SELECTION-SCREEN selbst wird als letztes Ereignis der Selektionsbildverarbeitung
ausgelöst, wenn alle Eingabewerte an das Programm übergeben wurden. In diesem Ereignisblock
können sämtliche Benutzereingaben überprüft werden. Das Senden einer Warnung oder Fehlermeldung im Ereignisblock macht alle Bildschirmfelder wieder eingabebereit.
Alternative 7
... ON ${ HELP-REQUEST $| VALUE-REQUEST $} FOR ${para$|selcrit-low$|selcrit-high$}
Wirkung
Die beiden Ereignisse ON HELP-REQUEST und ON VALUE-REQUEST werden bei den Dynpro-Ereignissen POH und POV eines Selektionsbildes ausgelöst, wenn für das Eingabefeld eines Parameters para oder eines der Eingabefelder eines Selektionskriteriums selcrit die Feldhilfe F1 bzw. die Eingabehilfe F4 aufgerufen wurde. Andere Selektionsbildereignisse werden nicht ausgelöst.
In den Ereignisblöcken kann eine selbst definierte Feld- bzw. Eingabehilfe programmiert werden,
welche die eventuell im ABAP Dictionary definierten Hilfen übersteuert. Die in den Ereignisblöcken
für ON VALUE-REQUEST geänderten Parameter und Selektionskritierien werden in die entsprechenden Felder des Selektionsbildes transportiert.
Hinweise
- Diese Ereignisblöcke können nur für Felder des Selektionsbildes implementiert werden, die im gleichen ABAP-Programm und nicht in einer eventuell verknüpften logischen Datenbank definiert sind.
- Bei den Ereignissen für die Feld- und Eingabehilfe werden keine Daten zwischen Selektionsbild und ABAP-Programm transportiert. Wie bei allgemeinen
Dynpros müssen
hierfür geeignete Funktionsbausteine wie RS_SELECTIONSCREEN_READ und RS_SELECTIONSCREEN_UPDATE verwendet werden.
Alternative 8
... ON EXIT-COMMAND
Wirkung
Dieses Ereignis wird ausgelöst, wenn der Benutzer eine der Funktionen Zurück,
Beenden oder Abbrechen aufgerufen hat. Im Ereignisblock können eventuelle Aufräumarbeiten vorgenommen werden.
Beispiel
Der folgende Abschnitt eines ausführbaren
Programms definiert ein Standardselektionsbild und ein weiteres Selektionsbild. In den Ereignisblöcken
AT SELECTION-SCREEN werden die Eingaben in die Selektionsbilder über die Auswertung des Namens p_carrid und die
Dynpro-Nummer in sy-dynnr gezielt behandelt.
ROGBILLS - Synchronize billing plans CL_GUI_FRONTEND_SERVICES - Frontend Services
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 12752 Date: 20240419 Time: 235951 sap01-206 ( 153 ms )
