Ansicht
Dokumentation

/BGLOCS/VATREPORT07_MENU - Example:List Tree Control (with Documentation)

/BGLOCS/VATREPORT07_MENU - Example:List Tree Control (with Documentation)

ROGBILLS - Synchronize billing plans   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.
SAP E-Book

Description

This program demonstrates the list tree control (class CL_GUI_LIST_TREE).

Each node in the tree is described by the ABAP Dictionary structure TREEV_NODE. The NODE_KEY field contains the key of the node.
Each node in the tree can posess items, each of which is described by the ABAP Dictionary structure TREEV_ITEM, to which the programmer must add a character field TEXT (of any length). In the example program, TREEV_ITEM is included in the structure MTREEITM, which, in addition, contains a field TEXT. The NODE_KEY field determines the node to which an item belongs. ITEM_NAME contains the name of the item. This field may only contain integer values from 1 upwards. The items of a node are displayed from left to right.

The example shows some important attributes of the list tree control:

  • Objects" tem: This item has proportional font ITEM-FONT = CL_GUI_LIST_TREE=>ITEM_FONT_PROP). You should only use proprortional font for an item if the width of the item is automatically adjusted to the length of the text string (so that the string always fits!). In order to do this, the ALIGNMENT field of the item must contain the value CL_GUI_LIST_TREE=>ALIGN_AUTO.
  • The items in the third and fourth nodes contain a tabular construction. For this to work, the first three items of each node must have a fixed length (ITEM-ALIGNMENT = CL_GUI_LIST_TREE=>ALIGN_LEFT, ITEM-LENGTH = ...) and you must use a fixed font for the items. (ITEM-FONT = ITEM_FONT_FIXED).

Selection

Items in a node can be selected individually. When you click the folder or leaf symbol of a node, the entire node is selected.
You can set the selection behavior of the tree so that clicking the node always selects the entire node. To do this, set the ITEM_SELECTION parameter of the constructor method to initial.

Events

The program displays events as they occur on the right-hand side of the screen. The following events can be triggered in the example program:

node_dbl_clk (node double click)

Double click on a node. In the example, this event is triggered when you double-click the folder/leaf symbol. If ITEM_SELECTION is set to SPACE, the event is triggered when you double-click anywhere on a node.

item_dbl_click (item double click)

Double click on an item in a node. This event can only occur if ITEM_SELECTION = 'X'.

expand_nc (expand no children)

You can make a node display a plus sign in its folder symbol even though it has no child nodes (by setting the EXPANDER field in TREEV_NODE). If the user clicks one of these nodes, the control triggers the event EXPAND_NC. In the example, the "Program" node has this attribute, and the program reacts to the event by adding two new nodes to the control.

button_click

The user clicked a pushbutton item.

link_click

The user clicked a link item.

Requirements

Output

Example






Addresses (Business Address Services)   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.

Length: 3235 Date: 20240328 Time: 140827     sap01-206 ( 76 ms )