Show TOC

CONSTRUCTORLocate this document in the navigation structure

Use

The constructor creates, initializes, and positions the control.

Note

The constructor method is called automatically when you instantiate the class ( create object statement). You generally pass the parameters of the method in the create object statement.

Features
create object docking_container

        exporting
                parent = parent
                dynnr = dynnr
                repid = repid
                side = side
                extension = extension
                style = style
                lifetime = lifetime
                metric = metric
                caption = caption
                no_autodef_progid_dynnr = no_autodef_progid_dynnr

        exceptions
                cntl_error = 1
                cntl_system_error = 2
                create_error = 3
                lifetime_error = 4
                lifetime_dynpro_dynpro_link = 5.
         

Parameter

Meaning

Possible Values

parent

Parent of the instance, that is, the contain in which the control is to be displayed

dynnr

Number of the screen to which you want to attach the control

repid

Report ID: Program to which you want to attach the control

side

Edge of the screen to which you want to attach the container

  • docking_container->dock_at_left : Left-hand edge

  • docking_container->dock_at_right : Right-hand edge

  • docking_container->dock_at_top : Top edge

  • docking_container->dock_at_bottom : Bottom edge

extension

Extension of the docking container (for example, width of the container when you attach it to the left-hand edge of the screen)

style

Controls the appearance and behavior of the control

Constants from the class CL_GUI_CONTROL that begin with WS_*

lifetime

Lifetime management parameter specifying the lifetime of the control

  • cntl_lifetime_imode : The control remains alive for the lifetime of the internal session (that is, until a statement such as leave program , leave transaction )

  • cntl_lifetime_dynpro : The control remains alive for the lifetime of the screen (that is, while it remains in the screen stack). It is not destroyed, for example, by a call screen 100 , call transaction .

metric

Metric

  • docking_container->metric_default : Screen metric (default)

  • docking_container->metric_pixel : Pixel

  • docking_container->metric_mm : Millimeters

caption

Heading

Any character field

no_autodef_progid_dynnr

Switches off automatic definition of the program ID and screen number.

  • space

    Program ID and screen number are used automatically (default value)

  • ' X '

    Switches off automatic definition of the program ID and screen number.