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:

empty

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:

To edit the text of a widget, select the widget in the Design Area or the Form Structure, then find the text property in the Properties view, double-click the value cell, and input your text.

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 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