InitialValue (Property)

..InitialValue is used to find out the initial value of a control found in a window or in 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 the Windows Phone applications.

New in version 16

This property is now available for the Windows Phone applications.

Versions 15 and later

This property is now available for the Android applications.

New in version 15

This property is now available for the Android applications.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the 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 the Table controls in the Android applications and in the iPhone/iPad applications.

New in version 20

This property is now available for the Table controls in the Android applications and in the 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 name>..InitialValue

<Initial value>: Any type

Initial value of specified control.

<Control name>: Character string (with or without quotes)

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 control, ..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 a HideShow control, ..InitialValue corresponds to the status of the control (expanded (1) or collapsed (0)) selected when creating the control.

Combo Box control

For a Combo Box control, ..InitialValue 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(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

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

Limits

In a window, ..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.

In a page, ..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).

a Chart control.

..InitialValue only applies to the following elements:

Edit Control.
Image.
Check box.
Radio button.
List Box.
Combo Box.
Table.
Supercontrol.

..InitialValue only applies to the Image controls.