Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  User Dialogs →  Dynpros →  ABAP Statements for Screens 

SET TITLEBAR - Dynpro

Short Reference

Other versions: 7.31 | 7.40 | 7.54

Syntax


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

Extras

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 one screen 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 Could not find GUI title.


Notes

  • The GUI title of the dynpro must be set before 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.
  • In standard selection screens, the statement SET PF-STATUS can be used at PBO time. In selection screens defined using SELECTION-SCREEN BEGIN OF SCREEN, the addition TITLE of this statement should be used instead.
  • 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 a 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 contents 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 based on 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 contents of the data objects text1 to text9, whose names contain the same number i for the second digit.
  • The non-numbered placeholders "&" are replaced with the contents 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 successive "&" characters "&&" in the title bar are not replaced with the contents 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 contents p1 and p2.

DATA: title TYPE string, 
      prog  TYPE string, 
      p1    TYPE c LENGTH 10, 
      p2    TYPE c LENGTH 10. 
... 
MODULE status_0100 OUTPUT. 
  ... 
  title = 'TITLE_0100'. 
  prog  = '...'. 
  p1 = '...'. 
  p2 = '...'. 
  SET TITLEBAR title OF PROGRAM prog WITH p1 p2. 
  ... 
ENDMODULE.