Splitter Controls 

Definition

A splitter control is a screen element that divides the area which it covers into two subscreen areas, either horizontally beside each other or vertically one above the other. The division is made by a sash. The horizontal or vertical position of the sash is specified statically in the definition of the splitter control. It can be set to PBO in the ABAP program and changed by the user whilst the screen is being displayed.

Usage

A splitter control can only be created in the alphanumeric Screen Painter by using Edit → Create Element → Splitter Control. For this reason it should only be used in cases when the functionality offered is required on classic dynpros. Usually, Web Dynpro ABAP should be used instead of classic dynpros for new developments.

Inserting subscreen dynpros into both subscreen areas takes place in exactly the same way as direct insertion using the CALL SUBSCREEN statement in the dynpro flow logic. Any subscreens can be inserted, particularly those that contain splitter controls again.

In ABAP programs, the position of the sash of a splitter control is controlled using an instance of the CL_DYNPRO_SPLITTER class. If, before sending this screen, an object of this class is created and its constructor is given the name of a splitter control, this is bound to the splitter control and its methods can be used to set and read the position of the sash. The sash position is specified as a percentage and refers to the width or height of the splitter control. In the object, the position is represented by a private attribute. Important methods of the class are:

GET_GUISASH

For PAI, it sets the sash position of the object to the current value of the bound splitter control.

SET_SASH

If no value is passed at the POSITION parameter, the method for PBO sets the sash position of the bound splitter control to the value of the object. If a value is passed at the POSITION parameter, the method for PBO sets the attribute of the object and the sash position of the bound splitter control to this value. For PAI, only the attribute of the object is set.

GET_SASH

Gets the sash position of the bound splitter control for PBO and PAI.

A splitter control can have a function code assigned to it, which can be used to react to changes to the sash position made by the user in ABAP programs.

Splitter controls offer certain advantages over the corresponding CFW containers. One advantage is that they allow all screen elements of a classic dynpro to be displayed directly in a flexible frame, another is that they have better performance than CFW controls. An example of intensive use of splitter controls is the flexible interface of the ABAP Debugger.