SAP Function RH_PRESENTATION_GRAPHIC_SHOW -

Parameter Reference Type Length Default Optional Text
CONTAINER C C 0 X Screen element name 'custom control'
HEADER C C 0 X Header (plot area)
HEIGHT I I 4 X Control height
INSTANCE GFW_CU_STR 0 'PD_GRAPHIC' X Operation
LEFT I I 4 X Alignment with left edge of parent object
ORIENTATION I I 4 1 X Analysis method for data tables
PARENT ANY A 0 X Container object in which the graphic is placed
PRESENTATION_TYPE I I 4 Diagram type
TOP I I 4 X Alignment with upper edge of parent object
WIDTH I I 4 X Control width
X_AXIS_TITLE GFWLABEL C 80 X
Y_AXIS_TITLE GFWLABEL C 80 X

Parameter Reference Type Length Text
RETVAL SYMSGNO N 3 First error

Parameter Reference Length Optional Text
COLUMN_LABELS GPRTXTLA 120 X
COLUMN_TEXTS GPRTXT 40 Column texts (maximum 32)
ROW_LABELS GPRTXTLA 120 X
VALUES GPRVAL 296 Row texts and (up to 32) values for each row

Exception Text
ERROR_OCCURRED GFW error

Functionality
GFW = Graphical Framework
GFW_PRES_SHOW is the GFW function module for business graphics.
It can display one(!) ActiveX or JAVABean ("control") graphic andincludes a fallback strategy for the platforms on which controls cannotbe run. On platforms that do not support controls the graphic isstarted as an external program (SAPBUSG).
The graphic product used by the function module is determined byproduct management, which is filled by SAP and enables the customer tochange the priorities of the products used.
The function module has IMPORTING and TABLES parameters and EXCEPTIONS.

Parameters

  • CONTAINER or PARENT (importing)

    • Container object in which the graphic is to be placed (PARENT must havethe data type TYPE REF TO CL_GUI_CONTAINER).
    • TOP (importing)

      • Alignment/upper edge of the parent object
      • LEFT (importing)

        • Alignment/left hand edge of the parent object
        • HEIGHT (importing)

          • Height of the control
          • WIDTH (importing)

            • Width of the control
            • PRESENTATION_TYPE

              • Diagram type = type in which all data series are represented (lines,points, vertical bar, pie ...)
              The presentation type is determined by the constants in type group GFW(please refer to the documentation for the parameterPRESENTATION_TYPE).
              • HEADER

                • Header (plot area)
                • ORIENTATION

                  • Specifies how the data tables are interpreted
                  • X_AXIS_TITLE

                    • Title/label for the X-axis
                    • Y_AXIS_TITLE

                      • Title/label for the Y-axis
                      • VALUES, COLUMN_TEXTS

                        • Tables with the data to be displayed
                        • ROW_LABELS, COLUMN_LABELS

                          • Table contains headings for the unique texts for the rows/columns

                          Example
                          Program DEMO_GFW_PRES_SHOW

                          Notes

                          • The constants of the GFW type pool must be used because the content of
                            • the constants may change!
                            • If you want to display several graphics with GFW function modules
                              • simultaneously, you can use the _MULT function module (here:GFW_PRES_SHOW_MULT).
                              • Requirements that go beyond the range of functions described here (in
                                • particular, forcing a specific graphic product and interaction) can beprogrammed directly using the GFW ABAP Objects Framework.

                                Description
                                The GFW has reported one or more errors. If the programming is correctthere should not be any errors.
                                Calling the method CL_GFW=>SHOW_MSG_PROTOCOL displays a list of allmessages listed in the GFW. You can find more information in thedocumentation for this method.

                                Description
                                Name of the screen element of the type "custom control" in which thegraphic is to be displayed (TOP, LEFT, HEIGHT, WIDTH are ignored ifCONTAINER is specified; CONTAINER is only effective if PARENT was notspecified).

                                Description
                                The parameter contains the heading for the graphic. It is displayed inthe drawing area.

                                Description
                                Height of the control (screen metric).
                                This parameter is only effective if the parameter CONTAINER was notspecified.

                                Description
                                Offset relative to the left edge of the screen (screen metric).
                                This parameter is only effective if the parameter CONTAINER was notspecified.

                                Description
                                Way in which the data tables are evaluated (as lines or as columns)
                                The appropriate constants are defined in the type group GFW(GFW_ORIENT_ROWS and GFW_ORIENT_COLUMNS).
                                The parameter ORIENTATION is explained here using an example. The twodata tables VALUE and COLUMN_TEXTS are provided. They are filled asfollows:
                                VALUE: i 1 5 COLUMN_TEXTS: TXT1
                                ii 2 6 TXT2
                                iii 3 7
                                Depending on the ORIENTATION the following graphics are displayed (withline or column display):

                                • GFW_ORIENT_ROWS:

                                  • Lines:
                                  3 lines, X-axis with headings TXT1 and TXT2. Legend for the lines withthe headings i, ii and iii.
                                  Columns:
                                  2 groups of columns each with 3 columns X-axis with TXT1 and TXT2 asheadings each under the groups of columns, legend for the columns foreach group with i, ii and iii as headings.
                                  • GFW_ORIENT_COLUMNS:

                                    • Lines:
                                    2 Lines, X-axis with i, ii and iii as headings, legend for the lineswith TXT1 and TXT2 as headings.
                                    Columns:
                                    3 groups of columns each with 2 columns, X-axis with i, ii and iii eachunder the column groups as headings, legend for the columns of eachgroup with TXT1 and TXT2 as headings.

                                    Value range
                                    The constants from the type group must be used.

                                    Default
                                    GFW_ORIENT_ROWS

                                    Description
                                    Reference to a container object (CL_GUI_CONTAINER) in which the graphicis to be placed.
                                    The parameter CONTAINER is ignored if PARENT is specified.

                                    Description
                                    Chart type = how all the data series are displayed (line, points,columns, pies, ..).
                                    You have to use the appropriate constants that are defined in the GFWtype pool:

                                    • GFW_PRESTYPE_LINES

                                    • GFW_PRESTYPE_AREA

                                    • GFW_PRESTYPE_HORIZONTAL_BARS

                                    • GFW_PRESTYPE_PIE_CHART

                                    • GFW_PRESTYPE_VERTICAL_BARS

                                    • GFW_PRESTYPE_TIME_AXIS (line chart with X-time axis)

                                      • Note: Time values must be specified in the format YYYYMMDDhhmmss!
                                      The contents of the constants may change in the future!
                                      Please note that a graphics product may not support a specific display.In this case you have to change the priorities in product management orselect another type of display.

                                      Description
                                      Offset relative to the upper edge of the screen (screen metric).
                                      This parameter is only effective if the parameter CONTAINER was notspecified.

                                      Description
                                      Width of the control (screen metric).
                                      This parameter is only effective if the parameter CONTAINER was notspecified.

                                      Description
                                      The parameter contains the heading for the X-axis. It is displayed inthe middle of the graphic below the X-axis.

                                      Description
                                      The parameter contains the heading for the Y-axis. It is displayed onthe left next to the Y-axis with the orientation from bottom to top. Inthis way the graphic itself has a lot of space.

                                      Description
                                      This table contains headings for the unique column texts inCOLUMN_TEXTS. The headings do not have to be unique.

                                      Description
                                      This table contains column texts (up to 32 columns=lines in thistable). The columns texts must be unique. They serve as keys.

                                      Description
                                      This table contains arbitrary headings for the unique line texts inVALUES. The headings do not have to be unique.

                                      Description
                                      This parameter contains a table with line texts and values (up to 32per line). The line texts must be unique. They serve as keys.