Ansicht
Dokumentation

/SAPAPO/SNPCOST1 - SNP: Pflege der Kosten

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Beschreibung

Der Report SAPTREX1 demonstriert die Verwendung des Tree Controls im Spaltenmodus.

Der dargestellte Baum hat drei Spalten. Eine Spalte wird durch die Dictionary-Struktur TREEV_COL beschrieben. Jede Spalte hat einen Namen (Feld NAME), der dazu dient, die Spalte anzusprechen. In diesem Beispiel wurden für die Spalten die Namen "Column1", "Column2" und "Column3" gewählt.
Die Spalten werden von Headern überspannt (Dictionary-Struktur TREEV_HDR). Der erste Header von links ist immer vorhanden und hat den Namen (Feld NAME) "HierarchyHeader" und die Überschrift "Hierarchy Header". Die Besonderheit dieses Headers ist, daß der linke Rand aller Spalten, die sich unterhalb dieses Headers befinden, mit der Hierarchietiefe der Knoten des Baumes fließt. Außerdem hat der Bereich unterhalb des Hierarchie-Headers einen eigenen horizontalen Scrollbar. Der Hierarchie-Header überspannt die Spalte mit dem Namen "Column1". Der Header mit der Überschrift "Header2" überspannt die Spalte mit dem Namen "Column2". Die Spalte mit dem Namen "Column3" wird vom Header mit der Überschrift "Header3" überspannt.

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 definiert, in welcher Spalte das Item steht.
Beispiel: Es folgen die drei Items des oberen Wurzelknotens:

NODE_KEY ITEM_NAME TEXT

Root Column1 Root Col. 1
Root Column2 Root Col. 2
Root Column3 Root Col. 3

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 Bausteins TREEV_CREATE_COLUMN_TREE initial setzten). In diesem Fall sind Drucktasten, Links und eingabebereite Ankreuzfelder nicht zulässig.

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.

item_context_men

Wird auf einem Item die rechte Maustaste gedrückt, so wird dieses Event gefeuert. Die Parameter des Events sind Schlüssel des Knotens und Name des Items.

node_context_men

Drückt der Benutzer auf dem Ordner-/Blatt-Symbol die rechte Maustaste, so wird dieses Event gefeuert. Der Parameter des Events ist der Schlüssel des Knotens.

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 "Child1" diese Eigenschaft. Das Beispielprogramm reagiert auf dieses Event mit dem Überspielen von zwei neuen Knoten an das Control (New1 und New2).

header_click

Der Benutzer hat einen Header des Controls geklickt. Im node_key-Ausgabefeld wird der Name des geklickten Headers angezeigt.

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

ROGBILLS - Synchronize billing plans   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4675 Date: 20240425 Time: 121840     sap01-206 ( 93 ms )