SELECTION-SCREEN - BLOCK

Short Reference

Syntax

SELECTION-SCREEN BEGIN OF BLOCK block
                                [WITH FRAME [TITLE title]]
                                [NO INTERVALS].
...
SELECTION-SCREEN END OF BLOCK block.

Extras:

1. ... WITH FRAME [TITLE title]

2. ... NO INTERVALS

Effect

These statements define a block with the name block on the current selection screen. You must specify the name block directly and it must contain a maximum of 20 characters.

All screen elements on the selection screen defined with PARAMETERS, SELECT-OPTIONS, and SELECTION-SCREEN statements between these statements are part of block block. You can create additional blocks within the definition of a block.

Note

Each block is assigned a selection screen event AT SELECTION-SCREEN ON BLOCK, in which the user entries within the block can be processed together.

Addition 1

... WITH FRAME [TITLE title]

Effect

The addition WITH FRAME draws a frame around a block that is not empty. A maximum of five blocks can be nested. Since Release 6.20, a standard width of 120 columns has been defined for the outer frame (the width was previously 83 columns). The frame of each nested block has been shortened by 4 columns.

You can specify the addition TITLE to define a title for a block with a frame. For the title title, you can either specify the name of a text symbol in the program in the form text-###, where ### stands for the three-character ID of the text symbol, or a name of your choice containing a maximum of eight characters. If you specify a name of your choice, the runtime environment generates a global variable of the same name, belonging to type c with a length of 70. When the selection screen is displayed, the content of the text symbol or the global variables is positioned at the top left hand corner of the frame. If the specified text symbol is not found, the system does not create a title.

Addition 2

... NO INTERVALS

Effect

If you specify NO INTERVALS, the addition of the same name, NO INTERVALS is used implicitly and the width of the block is reduced accordingly when defining all the selection criteria for this block in a SELECT-OPTIONS statement.

Example

Grouping radio buttons in a block with a frame and title on the standard selection screen for an executable program.

SELECTION-SCREEN BEGIN OF BLOCK rad1
                          WITH FRAME TITLE title.
PARAMETERS: r1 RADIOBUTTON GROUP gr1,
            r2 RADIOBUTTON GROUP gr1,
            r3 RADIOBUTTON GROUP gr1.
SELECTION-SCREEN END OF BLOCK rad1.

INITIALIZATION.
  title = 'Selection'.