Ansicht
Dokumentation
/BGLOCS/VATREPORT07_MENU - Beispiel: List Tree Control (mit Dokumentation)
Addresses (Business Address Services) CL_GUI_FRONTEND_SERVICES - Frontend ServicesDiese Dokumentation steht unter dem Copyright der SAP AG.
Beschreibung
Der Report SAPTLIST_TREE_CONTROL_DEMO demonstriert die Verwendung des List Tree Controls (Klasse CL_GUI_LIST_TREE).
Ein Knoten des Baumes wird durch die Dictionary-Struktur TREEV_NODE beschrieben. Das Feld NODE_KEY beinhaltet den Schlüssel des Knotens.
Jeder Knoten des Baumes kann Items besitzen. Ein Item wird durch die Dictionary-Struktur TREEV_ITEM
beschrieben, die der Verwender des Tree Controls um das Character-Feld TEXT (beliebiger Länge!)
erweitern muß. In diesem Beispielreport wird TREEV_ITEM in die Struktur MTREEITM inkludiert,
um ein Feld mit Namen TEXT hinzuzufügen. Das Feld NODE_KEY bestimmt, zu welchem Knoten ein Item
gehört. Das Feld ITEM_NAME beinhaltet den Namen des Items. Zulässig sind nur ganze Zahlen ab 1. Die Items eines Knotens werden von links nach rechts ausgegeben.
Das Beispiel zeigt einige wichtige Eigenschaften des List Tree Controls, die nachfolgend an einigen Items des Beispiels erläutert werden:
- Item "Objekte": Dieses Item hat Proportionalschrift (ITEM-FONT = CL_GUI_LIST_TREE=>ITEM_FONT_PROP). Die Verwendung von Proprtionalschrift ist bei einem Item nur dann sinnvoll, wenn die Breite des Items dem enthaltenen Textstring automatisch angepaßt wird (damit der String immer reinpaßt!). Hierzu muß in das ALIGNMENT-Feld des Items der Wert CL_GUI_LIST_TREE=>ALIGN_AUTO geschrieben werden.
- Mit den Items des dritten und vierten Knotens von oben wird ein tabellenartiges Gebilde aufgebaut. Hierzu ist es nötig, daß die ersten drei Items beider Knoten eine feste Länge haben (ITEM-ALIGNMENT = CL_GUI_LIST_TREE=>ALIGN_LEFT, ITEM-LENGTH = ...) Bei diesen Items muß dann eine Fixed Font verwendet werden (ITEM-FONT = ITEM_FONT_FIXED).
Selektion
Die Items eines Knotens sind einzeln selektierbar. Ein Klick auf das Ordner- / Blatt-Symbol eines Knotens selektiert den gesamten Knoten.
Das Selektionsverhalten des Baumes kann auch so eingestellt werden, daß ein Klick immer den gesamten Knoten selektiert (ITEM_SELECTION-Parameter des Konstruktors initial setzten).
Events
Im Rahmen am rechten Dynprorand werden aufgetretene Events angezeigt. Folgende Events können im Beispielprogramm ausgelöst werden:
node_dbl_clk (node double click)
Ein Knoten wurde doppelgeklickt. Im Beispiel ist dies durch Doppelklick auf das Ordner-/Blatt-Symbol zu erreichen. Wird ITEM_SELECTION auf SPACE-gesetzt, wird dieses Event gefeuert, wenn irgendein Teil des Knotens doppelgeklickt wird.
item_dbl_click (item double click)
Ein Item des Baumes wurde doppelgeklickt. Dieses Event kann nur auftreten, wenn ITEM_SELECTION = 'X' ist.
expand_nc (expand no children)
Ein Knoten kann die Eigenschaft haben, daß er am Ordner-/Blatt-Symbol ein + zeigt, obwohl im Control keine Kinder vorhanden sind (Feld expander in TREEV_NODE setzen). Klickt der Benutzer auf einen derartigen Knoten, so wird das Event EXPAND_NC gefeuert. Im Beispiel hat der Knoten "Programm" diese Eigenschaft. Das Beispielprogramm reagiert auf dieses Event mit dem Überspielen von zwei neuen Knoten an das Control.
button_click
Der Benutzer hat ein Item geklickt, welches eine Drucktaste ist.
link_click
Der Benutzer hat ein Item geklickt, welches ein Link ist.
Voraussetzungen
Ausgabe
Beispiel
rdisp/max_wprun_time - Maximum work process run time ABAP Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 3746 Date: 20240425 Time: 224750 sap01-206 ( 83 ms )
