Selection Data Form

The selection data form is used to create and manage all selections and buttons of the application. In the sub-lists the usage of the selections/buttons in menus / button areas can be checked and modified and profiles can be assigned.


In the Selection Data form you can:


Sublists

Menu Assignment
Profile Assignment


Fields and Functions in the Header Form

Selection Name name of the selection/button
Text text for selection/button
Userexit name of the action to be executed
Length row length of the button
Width column width of the button
Description help text for push button
Access access to selection/button

Selection Name

A menu item or button name

attribute master attribute for selection (T_SELECTION)
type, entry string, entry required
max. no. of characters 20
selection tool no
multilingual field no

The item's name identifies it uniquely as a menu item or button. You can enter (or select) existing item or button names, or create new items.


Syntax for menu items or buttons in edit menus or button areas:

If you define a menu item or button to be used in an Edit menu or Edit button area, you can determine the edit modes which the item is available.

Syntax:

Name
always available

Name@I
available for Insert mode

Name@U
available for Update mode

Name@Q
available for Query mode

Name@V
available for View mode

Name@IU
e.g. available for Insert and Update modes (other combinations are also possible)

More information: -> Edit menus, -> Edit buttons


Syntax for menu item or button area placeholders

Syntax:

@MENUNAME
placeholder to insert a menu item or button area in a parent menu or button area

More information: -> Menu components, -> Button area components


Syntax for choice box in toolbars

Syntax:

@CBOXName
choice box in toolbar, only items in the choice box available

@EBOXName
choice box in toolbar, items may be selected or entered into the field

More information: -> Hierarchies in toolbars (sub objects)

Selection Text

Text for selection/push button/radio button or image file name for push button or macro for file card

attribute master attribute for selection (T_SELECTION)
type, entry string, entry required
max. no. of characters 50
selection tool no
multilingual field yes

The syntax for entries in this field depends on the desired menu definition and the way the item should be shown in the menu.


Menu Item:

Syntax:

Text
simple menu item, text shown left flush, first unique character automatically underlined for keyboard shortcut (to use a different character place an & before the character)

- (hyphen)
creates a separator (line) in the menu, see also the Userexit field

#Filename:Text (Note: filename without .bmp suffix)
adds an icon to the left of the item's text

@TABLENAME.COLUMNNAME
column entries from a table are used as menu texts, creates selectable text from each column entry, more than one column may be specified (Syntax: ... .COLUMNNAME1, COLUMNNAME2, ...); for the WHERE definitions see -> Field Parameters.

See also -> Display options for menu texts, -> Automatically creating menu texts


Pushbuttons:

Syntax:

Text
text centered in the pushbutton

#Filename (Note: filename without .bmp suffix)
icon centered in pushbutton

#Filename:Text
icon followed by text

Note! When a pushbutton is in a mask's button area, the text by the icon is automatically hidden.

More information: -> Text or icons on buttons, -> Display options for toolbars


Radio button:

Syntax:

Text
Text appears on the right near the radio button and is entered into the corresponding field when the button is selected

More information: -> Texts for radio buttons


Index Card:

Syntax:

@TAB P:TEXT (no separator)
button displayed in forms as a tabbed index card, index card groups are possible

P (position of the tab)
T = Top: above the index card

B = Bottom: below the index card

L = Left: to the left of the index card

R = Right: to the right of the index card

TEXT
text to be shown in the tab

More information: -> Using index cards in forms


Choice box in toolbars

Syntax:

Text
text to be displayed in the field (you may use text macros, e.g. @GROUP)

More information: -> Hierarchies in toolbars (sub objects)

Userexit

Name of the action to be executed

attribute master attribute for selection (T_SELECTION)
type, entry string, entry optional
max. no. of characters 20
selection tool menu with all menu userexit functions (separated for system- and user-library)
multilingual field no

Determines the function to be executed when a menu item is selected or a button is pressed.

Userexit:
you can also enter parameters to be passed to the userexit in the -> Parameters field.

@NEXT
display a child menu. The name of the child menu must be entered as a parameter in the -> Parameters field.

@LINE
used when the Text field contains a hyphen (for a separator).

@BREAK:
Client-Server abort (buttons only). You poll the state of an abort button with the gfi_chk_brk function.

Userexits can be launched from the trigger.

More information: -> Triggers on menu items and buttons, -> List of standard menu userexits

Length

Number of rows occupied by a button

attribute master attribute for selection (T_SELECTION)
type, entry Integer, entry optional, > 0
max. no. of characters 5
selection tool no
multilingual field no

Only applies to buttons. An entry is required for menu items, but is not used anywhere.

Length and width rules:

Pushbutton in a form
freely scalable

Pushbutton in a list
length must be 1, width can be anything

Pushbutton in a toolbar
0/0 for automatic sizing and positioning, otherwise can be anything

Radio button
length and width affect only the text attached to the radio button

Index card
0/0 for the first index card allows index card groups to be automatically sized, otherwise can be anything

More information: -> Positioning pushbuttons in masks, -> Display options for toolbars, -> Radio buttons, -> Appearance of index card groups

Width

Number of columns occupied by a button

attribute master attribute for selection (T_SELECTION)
type, entry Integer, entry optional, > 0
max. no. of characters 5
selection tool no
multilingual field no

Only applies to buttons. An entry is required for menu items, but is not used anywhere.

Length and width rules:

Pushbutton in a form
freely scalable

Pushbutton in a list
length must be 1, width can be anything

Pushbutton in a toolbar
0/0 for automatic sizing and positioning, otherwise can be anything

Radio button
length and width affect only the text attached to the radio button

Index card
0/0 for the first index card allows index card groups to be automatically sized, otherwise can be anything

More information: -> Positioning pushbuttons in masks, -> Display options for toolbars, -> Radio buttons, -> Appearance of index card groups

Description

Help text for push button

attribute master attribute for selection (T_SELECTION)
type, entry string, entry optional
max. no. of characters 63
selection tool no
multilingual field yes

The entry applies only to pushbuttons and radio buttons. When the cursor moves over the button, the text appears as a tool tip alongside or below it.

Access

Access privileges for a menu item or button

attribute master attribute for selection (T_SELECTION)
type, entry string, entry optional
max. no. of characters 1
selection tool menu with all kind of accesses
multilingual field no

Entry:

n
no access for any user

a
access for all users (default)

p
access for profiles, i.e. only for users whose profiles are contained in the item's profile assignment

More information: -> User access to menu items, -> User access to buttons