Ansicht
Dokumentation

GRAPH_RECEIVE - Grafik Receive-call emfangen

General Data in Customer Master   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Der Funktionsbaustein GRAPH_RECEIVE ermöglicht es Ihnen, auf Benutzereingaben zu warten. Das Grafikprogramm meldet GRAPH_RECEIVE alle Eingaben, die der Benutzer im Grafikfenster vornimmt (Mausklicks, Auswahl von Menüeinträgen, Tastatureingaben, Schließen von Fenstern). Anschließend muß das ABAP/4-Programm den jeweiligen Funktionsbaustein GET_xxxx_PARAM aufrufen, um die Rückgabeparameterwerte für das Grafikprogramm zu aktivieren.

Wenn in Ihrem Programm mehrere Fenster geöffnet werden können, werden die Funktionsbausteinaufrufe in der Regel in eine Programmschleife eingereiht. Sobald GRAPH_RECEIVE eine neue Benutzereingabe meldet, wird die Programmschleife gestartet. (Einzelheiten hierzu finden Sie in der Dokumentation BC - SAP-Grafik: Programmierschnittstellen im Abschnitt "Dialoganwendungen programmieren" unter "Aktuelle Dialogprogrammierung".)

Bereits vorhandene ABAP/4-Programme, die mit dem alten Wartemechanismus arbeiten, laufen nach wie vor korrekt ab. Für neue Programme sollten Sie jedoch GRAPH_RECEIVE verwenden. Benutzen Sie nicht beide Wartemechanismen zusammen in einem Programm.

Auf Benutzereingaben warten

Jedes ABAP/4-Programm, das mit Grafikfunktionsbausteinen arbeitet, muß GRAPH_RECEIVE aufrufen, um die Wartefunktion zu aktivieren. Die Wartefunktion "realisiert" die mit STAT angeforderten Aktionen und ist daher auch dann notwendig, wenn Ihr Programm nicht auf Benutzereingaben reagiert.

• Neu erstellte Fenster werden erst auf dem Bildschirm angezeigt, wenn GRAPH_RECEIVE aufgerufen wird.

• An bereits vorhandene Fenster gesendete Daten werden erst angezeigt, wenn GRAPH_RECEIVE aufgerufen wird.

Die Grafikprogramme melden die Eingaben, die der Benutzer über Maus und Tastatur vornimmt, wie z. B. Auswahl von Diagrammobjekten, Menüeinträgen oder Drucktasten. Der Funktionsbaustein GRAPH_RECEIVE nimmt Nachrichten von allen Grafikprogrammen entgegen, die auf der Workstation des Benutzers laufen, und kehrt erst zurück, wenn er eine Eingabenachricht erhalten hat. Dabei spielt es keine Rolle, welche Benutzeraktion die Nachricht meldet, es kann sich auch nur um das Schließen eines Fensters handeln. Das ABAP/4-Programm verwendet GRAPH_RECEIVE zusammen mit den Funktionsbausteinen GET_xxxx _PARAM der jeweiligen Grafikprogramme. Die Buchstaben xxxx sind Platzhalter für die Akronyme der Grafikprogramme: BMAT, BUSG, GANTT, HIER, HPGL, PORT oder STAT.

Hinweis:
GRAPH_RECEIVE wird implizit von den Funktionsbausteinen CNET_GRAPHIC_NETWORK, CNET_GRAPHIC_HIERARCHY und CNET_GRAPHIC_CLUSTER des SAP-Netzplanprogramms verwendet. Bei diesen Funktionsbausteinen handelt es sich um eine Kombination verschiedener Funktionsbausteine.

Parameter

ERRORCODE
MCODE
RWNID

Ausnahmen

FRONTEND_ERROR
INV_COMMUNICATION
NO_BATCH

Funktionsgruppe

GRAP

General Material Data   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3757 Date: 20240523 Time: 044622     sap01-206 ( 85 ms )