InitialValue (Property)

The InitialValue property is used to get the initial value of a control in a window or page. This value corresponds to the initial value defined in the editor ("Content" tab of the control description window).

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Android widget mode.

New in version 18

This property is now available in Android widget mode.

Versions 20 and later

This property is now available for Table controls in Android and iPhone/iPad applications.

New in version 20

This property is now available for Table controls in Android and iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Versions 23 and later

This property is now available in browser code.

New in version 23

This property is now available in browser code.

Example

// Initialize the value of "EDT_Customer" with its initial value
EDT_Customer = EDT_Customer.InitialValue

Syntax

<Initial value> = <Control used>.InitialValue

<Initial value>: Any type

Initial value of specified control.

<Control used>: Control name

Name of the control to be used.

Remarks

ActiveX control

For an ActiveX control, the initial value corresponds to the COM identifier (ProgID) of the ActiveX selected when creating the window.

iFrame control

For an iFrame control, the InitialValue property corresponds to:

the name of the page displayed (name selected in the description window of iFrame control). For example: "MyPage1".
a full URL if the page displayed corresponds to a page of another Internet site.

Chart control

For a Chart control, the initial value corresponds to the image displayed in the control background, selected when creating the window or the page.

Drawer control

For a Drawer control, the InitialValue property corresponds to the state of a control (expanded (1) or collapsed(0)) selected when the control was created.

Combo Box control

For a Combo Box control, the InitialValue property is used to read again the initial string assigned to the element.

For example, if the following code is used to add an element:

ListAdd(COMBO_Combo1, gImage(nImageNum,i) + "Customer.CustomerName" + i + ...
gStoredValue("Customer.CustomerName" + i))

the following code is used to read the initial string again:

COMBO_Combo1[1].InitialValue

Remark: The result of DisplayedValue does not allow you to retrieve information about te content added by gStoredValue.

Limitations

In a window, the InitialValue property cannot be used on:

a window,
a Static control,
a Button control,
a Shape control,
an option in a radio button or check box,
a row in a list box, listview or table,
a cell or a column in a table,
a menu,
a tab pane,
a group of controls,
an element in a TreeView control.

In a page, the InitialValue property can only be used on:

an Edit control,
a formatted display control,
a Combo Box control,
a List Box control,
a Static control,
a Table control,
Versions 20 and later
a Rich Text Area control,
New in version 20
a Rich Text Area control,
a Rich Text Area control,
Versions 20 and later
a layout cell (if the cell is in stream mode).
New in version 20
a layout cell (if the cell is in stream mode).
a layout cell (if the cell is in stream mode).

The InitialValue property applies only to the following elements:

Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
Table control.
Supercontrol.

The InitialValue property applies only to Image controls.