text

text specifies the text associated with a widget. Depending on a widget ↓ , it can be a widget's label text, its default value, or a path to any content to be displayed.

Form XML code:

depends on a widget

For example,

or

Possible values:

depend on the user's needs

Default value:

depends on a widget

Browser	www.querix.com
Button	Button N	N is the number of the button in the order of their addition to the form
Calendar	<no text>
FunctionField	<no text>
ComboBox	<no text>	every ComboBox option, once added gets the text - valueN - where N is the number of the item in the order of their addition to the form
Label	New Label	by default, every new label will hold the same text regardless of how many labels there are in the form
ListBox options	valueN	N is the number of the option in the order of their addition to the form
MenuGroup	Menu group	by default, every new menu group will hold the same text regardless of how many menu groups there are in the form
MenuCommand	Menu command	by default, every new menu command will hold the same text regardless of how many menu commands there are in the form
TextArea	<no text>
TextField	<no text>
ToolbarButton	tbButtonN	N is the number of the toolbar button in the order of their addition to the form
TimeEditField	<no text>

Associated containers, widgets and theme elements:

Browser Button Calendar FunctionField ComboBox (and its options) Label ListBox options

MenuGroup MenuCommand TextArea TextField ToolbarButton TimeEditField

Associated 4gl syntax:

DISPLAY ... TO ↓

Associated ui methods:

setText ↓

getText

ui.Form.setElementText

ui.ComboBox.getItemText

ui.ComboBox.getTextOf

Influence and behavior:

Here is the information the text property specifies for each associated widget:

• with Button, Label, ComboBox, ListBox, MenuGroup, MenuCommand, ToolbarButton, specifies the widget's label text

  

  

• with Calendar, FunctionField, TimeEditField, ComboBox, specifies the text to be displayed in the widget's field

  

  

• with TextArea and TextField, specifies the default text to be displayed at runtime

  

  If the property is not set, the widget will hold no text:

  

• with Browser, specifies the browser content; holds either a URL address of a web-page or a path to a file to be displayed

  

  

  

  

  The browser's ability to display a definite file depends on whether your have the necessary plug-in installed on your computer to open this file.

 

To change the text of a widget in the form,

• double-click the widget and type the new text directly into it:

  

• change the value of the property in the Properties pane:

  

 

To change the text of a widget at runtime,

• apply SetText method to the corresponding ui element.

  LET widget_var = ui.<widget>.ForName("widget_id1")

  CALL widget_var.setText("your text")

  DEFINE br ui.Browser ... LET br = ui.Browser.ForName("br1") CALL br.setText("www.bloomberg.com")
  DEFINE bt ui.Button ... LET bt = ui.Button.ForName("bt1") CALL bt.setText("ui.SetText")
  DEFINE tf ui.TextField ... LET tf = ui.TextFiled.ForName("tf1") CALL tf.setText("ui.SetText")

• display the necessary text to a widget using DISPLAY ... TO.

  DISPLAY "your text" TO widget_id

  DISPLAY "qx://application/wc01" TO br1
  DISPLAY "DISPLAY...TO"TO bt1
  DISPLAY "DISPLAY...TO" TO tf1