identifier

identifier specifies the identifier which will be used to refer to the form element in 4gl code or theme file.

Form XML code:

Possible values:

depend on the user's needs

Default value:

depends on a widget

root container	rootContainer
Table	TableN	N is the number of the container in the order of their addition to the form (regardless of whether these containers were tables or not)
TreeTable	TreeTableN	N is the number of the container in the order of their addition to the form (regardless of whether these containers were tree tables or not)
other containers	cN	N is the number of the container in the order of their addition to the form (root container is not counted)
BlobViewer	blN	N is the number of the widget in the order of their addition to the form
Browser	brN
Button	btN
Canvas	cvN
Label	lbN	N is the number of the widget in the order of their addition to the form
MenuBar	cN+1	N is the number of containers added to the form (root container is not counted)
MenuGroup	mgN	N is the number of the widget in the order of their addition to the form
MenuCommand	mcN
MenuSeparator	msN
PlaceHolder	PlaceHolderN
ProgressBar	pbN
Separator	lsN	N is the number of the widget in the order of their addition to the form
Toolbar	mainToolbarN+1	N is the number of containers and bars (menu and toolbar) added to the form (root container is not counted)
ToolbarButton	tbButtonN	N is the number of the widget in the order of their addition to the form
ToolbarSeparator	tbSeparatorN
other widgets	fN

Associated containers, widgets and theme elements:

BorderPanel CoordPanel GridPanel GroupBox StackPanel ScrollViewer Tab TabPage Table TreeTable

BlobViewer Button Calendar Canvas CheckBox ComboBox FunctionField Label BlobViewer

MenuBar MenuGroup MenuCommand PlaceHolder ProgressBar RadioGroup ListBox Separator

Spinner TextArea TextField Toolbar ToolbarButton TimeEditField WebComponent

Associated functions:

fgl_getlastwidgetid()

fgl_dialog_getfieldname()

Associated 4gl syntax:

INPUT ↓

DISPLAY ↓

Associated ui methods:

forName ↓

SetIdentifier ↓

GetIdentifier ↓

Influence and behavior:

identifier is used to provide a unique name for any form element.

To change the default identifier,

• change the value of the identifier property:

  

  If you try to specify an improper symbol combination as a widget identifier, you will get a corresponding warning

  

•  apply SetIdentifier method to the corresponding ui element:

  LET bt = ui.Button.forname("bt")

  CALL bt.SetIdentifier("newID")

You can use GetIdentifier method to find out widgets identifiers at runtime:

Widget identifiers are used

• to apply theme properties:

  property set in the form
  runtime appearance

• to create ui elements by binding the widget with the ID passed as an argument to a variable of a corresponding data type:

  LET bt = ui.Button.forname("bt")

• to refer to the widget in 4gl code:

  INPUT BY NAME f1

  DISPLAY "New Button" to bt