SAP NetWeaver AS ABAP Release 740, ©Copyright 2014 SAP AG. All rights reserved.
ABAP Keyword Documentation → ABAP − Reference → User Dialogs → Screens → ABAP Statements for Screens →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
... 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.
... 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:
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.