InitialValue (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

ActiveX control
iFrame control
Chart control
Drawer control
Combo Box control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Properties associated with windows, pages and controls

InitialValue (Property)

In french: ValeurInitiale

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

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,
a Rich Text Area control,
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.