Connection Functions Flags 

The connection functions flags control the connection operation.

The connection functions flags also allow you to specify how the controls on the screen are treated. More specifically, with these flags you can specify that the coordinates of the controls on the screen are expressed relative to the parent controls, as opposed to as absolute coordinates from the top of the screen.

Applies to

It_NewConnection, It_NewGroupConnection, It_NewServerConnection

Values

The following table lists the flags and their description.

SAPGUI_FRONT

Starts SAPGUI Front with connection startup. The default is to not invoke Front.

SAPGUI_R2

Indicates that the connection is to an R2 system. The default is to connect to an R3 system.

SAPGUI_FULLMENU

Gets the complete menu tree from the server. Note that SAPGUI in releases prior to 4.5A does not support the menu tree feature. Do not use this flag with SAPGUI Front of earlier releases.

SAPGUI_ABSOLUTE_COORD

Specifies that the coordinates of controls on the screen are expressed as their absolute location on the screen. (The default is to express the coordinates of controls on the screen as their location relative to their parent control, if they have a parent.)

SAPGUI_45A_COORD

Specifies that the coordinates of controls on the screen are expressed as a mixture of absolute and relative location, keeping the behavior of 4.5A GUI Library in this respect intact. This flag is provided only to preserve compatibility with applications using GUI Library of versions earlier and up to 4.5A.

(The default is to express the coordinates of controls on the screen as their location relative to their parent control, if they have a parent.)

SAPGUI_ACTIVEX

Specifies that the data of ActiveX controls on an R/3 application screen is communicated directly between the R/3 application server and the SAP GUI Front, without being communicated to the GUI Library.

This flag is provided as a limited support for ActiveX controls on a SAP GUI Screen.

Use this flag with a caution: using this flag in your application prohibits you from sending any event to R/3 or to Front.

The default is to not provide this ActiveX support.

For more details, see the discussion in Using Screens with ActiveX Controls.

The default value for the flags is zero (0). If you specify zero, the connection functions take the default behavior, which is to not invoke Front, to not provide ActiveX support, and to connect to an R/3 system. It also then uses relative coordinates for controls on the screen.