SET TITLEBAR - Dynpro
SET TITLEBAR title [OF PROGRAM prog]
[WITH text1 ... text9].
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
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.
|0||GUI title has been set.|
|4||Could not find GUI title.|
- 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-STATUScan be used at PBO time. In selection screens defined using SELECTION-SCREEN BEGIN OF SCREEN, the addition
TITLEof this statement should be used instead.
SET TITLEBARcontains a variant for the GUI status of lists.
... OF PROGRAM prog
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
When using the addition
WITH, the placeholders of the GUI title can be replaced
by the formatted contents of data objects
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
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
text9according 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
text9, but with the character "&".
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.
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
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.