Ansicht
Dokumentation

ABAPSET_TITLEBAR_DYNPRO - SET TITLEBAR DYNPRO

ABAPSET_TITLEBAR_DYNPRO - SET TITLEBAR DYNPRO

PERFORM Short Reference   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.
SAP E-Book

SET TITLEBAR, Dynpro

Short Reference



SET TITLEBAR title $[OF PROGRAM prog$]
                   $[WITH text1 ... text9$].


Additions

1. ... OF PROGRAM prog

2. ... WITH text1 ... text9

Effect

When dynpros are processed, this statement specifies the GUI title specified in title for the subsequent screens. The title is displayed in the title bar from the next sending of a screen layout until the end of the program or until the next SET TITLEBAR statement. The name of the current GUI title is displayed in the system field sy-title.

title expects a character-like data object that contains the name of a GUI title of the main program of the current program group or of the program specified in prog in uppercase letters. If the title does not exist, sy-subrc is set to 4 and the word "SAP" is displayed in the title bar.

System Fields

sy-subrc Meaning
0 GUI title has been set.
4 GUI title was not found.

Notes

  • The GUI title of the dynpro must be set at the latest at the PBO event. If no GUI title is set for a dynpro, the word "SAP" is displayed in the title bar.
  • The title bar can contain a maximum of 70 characters. A title that exceeds this limit after the replacement of placeholders is truncated to the right.
  • The statement SET TITLEBAR contains a variant for the GUI status of lists.

Addition 1

... OF PROGRAM prog

Effect

By default, a GUI title defined in the current main program is used. When using the addition OF PROGRAM, a GUI title of the program specified in prog can be set. prog expects a character-like data object that contains the name of an ABAP program in uppercase letters.

Addition 2

... WITH text1 ... text9

Effect

When using the addition WITH, the placeholders of the GUI title can be replaced by the formatted content of data objects text1 to text9. Data objects text1 to text9 can have the same data type as a source field of the statement WRITE TO and are formatted according to the predefined formats. The placeholders of the GUI title can be defined in the form "&" or "&i", where i can be a number between 1 and 9. The replacement process works as follows:

  • The numbered placeholders "&i" are replaced with the formatted content of the data objects text1 to text9, whose names contain the same digit i in the second place.
  • The non-numbered placeholders "&" are replaced with the content of the remaining data objects text1 to text9 according to their order.

If no data object is specified for a placeholder, it is represented by a blank character. Two consecutive "&" characters "&&" in the title bar are not replaced with the content of text1 to text9, but with the character "&".

Note

If a GUI title is to be translated into other languages, the numbered placeholder "&i" should be used, since the structure of the sentence can change.

Example

In the following example, the GUI title TITLE_0100 of the program specified in prog is set in a PBO module, where the placeholders "&1" and "&2" of the title are replaced with the formatted content p1 and p2.






Addresses (Business Address Services)   ABAP Short Reference  
This documentation is copyright by SAP AG.

Length: 6032 Date: 20240329 Time: 161044     sap01-206 ( 94 ms )