Ansicht
Dokumentation
GRAPH_STRUCTURAL - SAP-Strukturgrafik: ABAP/4-Schnittstelle
PERFORM Short Reference BAL Application Log DocumentationDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Der Funktionsbaustein GRAPH_STRUCTURAL dient als Grafiktreiber für die SAP Strukturgrafik. Mit der Strukturgrafik können beliebige hierarchisch darstellbare Strukturen angezeigt und bearbeitet werden.
Der einzige obligatorische Parameter ist die Objekttabelle. Darin enthalten sind auch die Verknüpfungen zwischen den Objekten.
Darüberhinaus gibt es einige Standard-Dialogparameter zur Steuerung von mehreren SAP-Grafiken gleichzeitig sowie zum Layout der Strukturgrafik beim Start.
Anstatt die Strukturgrafik direkt am Bildschirm anzuzeigen, kann sie auch als SAPoffice-Objekt an einen anderen Benutzer verschickt werden. Dabei wird ein Dokument vom Typ 'GRA' erzeugt, sodaß beim Auswählen des Dokuments im Eingangskorb die Strukturgrafik mit den gesendeten Daten geöffnet wird.
Der Funktionsbaustein wird verlassen, wenn entweder eine Nachricht von der Strukturgrafik empfangen wurde (z.B. Bearbeitungsfunktionen) oder eine Nachricht von einer anderen Grafik vorliegt, die ebenfalls gestartet wurde. Als Rückgabeparameter erhält man das Handle der Grafik, die die Nachricht ausgelöst hat sowie einen Nachrichtentyp.
Zur weiteren Auswertung der empfangenen Nachricht steht der Funktionsbaustein GET_STRU_PARAM für die Strukturgrafik oder je ein Funktionsbaustein GET_xxxx_PARAM für die anderen Grafiktypen zur Verfügung.
Eine Ausnahme wird ausgelöst, wenn entweder beim Start oder beim Nachladen die Objekttabelle leer ist oder wenn der Zugriff auf die Datenbankstruktur GSUOBJC gescheitert ist. Letzteres gilt nur bei der Verwendung des Werkzeugkastens.
Zur Dokumentation der Standard-Dialogparameter sowie zu Fragen der Dialog-Programmierung benutzen Sie bitte das Handbuch 2582 "BC SAP Graphics Programming Interfaces".
Über die in diesem Funktionsbaustein vorhandenen Parameter hinaus gibt es noch weitere Funktionsbausteine zur Steuerung der Strukturgrafik:
GRAPH_STRU_SET_DISPLAY
Mit diesem Funktionsbaustein kann ein beliebiger Text in einem kleinen Info-Fenster angezeigt werden. Dieser Funktionsbaustein ist u.a. dann sinnvoll, wenn beim Auswählen von Objekten in der Grafik Infos zum markierten Objekt angezeigt werden sollen.
GRAPH_STRU_SET_MESSAGE
Mit diesem Funktionsbaustein kann eine Nachricht an die Grafik geschickt werden, die dort in der Statuszeile angezeigt wird.
GRAPH_STRU_SET_OPTIONS
Es gibt in der Strukturgrafik zahlreiche Einstellungsmöglichkeiten, die nicht alle von dem Funktionsbaustein GRAPH_STRUCTURAL verwaltet werden können. Diese Einstellungen können vor dem Start der Grafik mit Hilfe dieses Funktionsbausteins voreingestellt werden.
GRAPH_STRU_SET_PROFILES
Zur Farb- und Formgestaltung von Objekten und Verknüpfungslinien gibt es in der Strukturgrafik die Möglichkeit, zwei Design-Profile zu verwenden, und zwar ein typorientiertes Design (abhängig vom Objekttyp bzw. der Verknüpfungsart) und ein statusorientiertes Design (abhängig vom Status des Objekts bzw. der Verknüpfung). Diese Profile werden der Strukturgrafik vor dem Start mithilfe dieses Funktionsbausteins bekanntgemacht.
GRAPH_STRU_SET_TOOLBOX
Eine wichtige Funktionalität der Strukturgrafik ist die Bearbeitung der Struktur bzw. der Objekte. Die gewünschten Bearbeitungsfunktionen werden in einem Werkzeugkasten in Form eines amodalen Fensters und wahlweise als Erweiterung der Menüleiste bereitgestellt. Vor dem Start der Grafik kann mit diesem Funktionsbaustein der Werkzeugkasten definiert werden.
Beispiel
Ein Beispiel mit einer zufällig generierten hierarchischen Struktur und wenigen ausgewählten Bearbeitungsfunktionen bietet das Programm BCGRSU01.
Hinweise
Weiterführende Informationen
Parameter
ADDSHAPESAPPLTITLE
EDITABLE
EXTACTBAR
FOCUS
M_TYP
NEWFORMAT
OBJECTS
PATTERN
PWDID
REFRESH
RWNID
SO_CONTENTS
SO_RECEIVER
SO_SEND
SO_TITLE
STATUS
SUPER
TBOXOPEN
TBOXPOSX
TBOXPOSY
TBOXSIZEX
TBOXSIZEY
TBOXTITLE
THELPTEXT
TOOLSTITLE
TSETSTITLE
VERSION30A
VIEWTITLE
WINID
WINPOSX
WINPOSY
WINSIZEX
WINSIZEY
Ausnahmen
GET_TABLEINFO_FAILEDNO_OBJECTS
Funktionsgruppe
GSUXBAL_S_LOG - Application Log: Log header data Fill RESBD Structure from EBP Component Structure
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 6595 Date: 20240523 Time: 065946 sap01-206 ( 105 ms )
