InitialValue (Property)

The Property Initial value allows to know the initial value of an control of a window or a page.. The initial value corresponds to the initial value defined in the editor ("Content" tab of the description window of control).

Versions 16 and later

This property is now available for Windows Phone applications.

New in version 16

This property is now available for Windows Phone applications.

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 Windows Store Apps mode.

This property is now available in Android Widget mode.

New in version 18

This property is now available in Windows Store Apps mode.

This property is now available in Android Widget mode.

This property is now available in Windows Store Apps mode.

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 control to use.

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 field, the Property InitialValue 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 an Drawer control, the InitialValue property corresponds to the report of the control (unrolled (1) or rolled up (0)) selected during the creation of the control.

Combo Box control

For an Combo Box control, the InitialValue property is used to re-read the initial string assigned to the element.

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

ListAdd(Combo1, gImage(nImageNum,i) + "Customer.CustomerName" + i + ...
gLink("Customer.CustomerName" + i))

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

Combo1[1].InitialValue

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

Limits

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

a window,
a caption,
a button,
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,
a TreeView element.

Within a page, the Property InitialValue 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 Property InitialValue applies only to the following items:

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

The Property InitialValue applies only to Image fields.