InitialContent (Property)

of a List Box control populated programmatically.
of a Combo Box control populated programmatically.
of a "List of values" column found in a Table control.
Versions 20 and later
in a Spreadsheet control.
New in version 20
in a Spreadsheet control.
in a Spreadsheet control.

This initial content was defined:

when describing the control ("General" tab of the List Box control, Combo Box control or "List of values" column).
Versions 20 and later
when initializing the Spreadsheet control in the window editor.
New in version 20
when initializing the Spreadsheet control in the window editor.
when initializing the Spreadsheet control in the window editor.

Remark: The initial content of List Box or Combo Box controls can also be modified through programming if they are found in a Looper control.

Important: A Looper control is used to create an 'Initial content' attribute on a Combo Box or List Box control. Therefore, a different content can be found for the List Box or Combo Box controls for each occurrence of this looper.

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.

New in version 18

This property is now available in Windows Store apps mode.

Versions 20 and later

This property is now available for table columns in iPhone/iPad applications.

New in version 20

This property is now available for table columns in 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

// Clears the list and restores its initial content
ListDeleteAll(LIST_List1)
ListAdd(LIST_List1, LIST_List1.InitialContent)

Syntax

Getting the initial content of a control Hide the details

<Initial content> = <Control used>.InitialContent

<Initial content>: Character string

List of elements entered in the window editor or in the page editor for the initial content of the object. The elements are separated by CR characters.

<Control used>: Control name

Name of the control with the initial content. This control must be a:
List Box populated programmatically,
Combo Box populated programmatically,
"List of values" column,
Versions 20 and later
Spreadsheet initialized in the window editor.
New in version 20
Spreadsheet initialized in the window editor.
Spreadsheet initialized in the window editor.

Modifying the initial content of a List Box control, Combo Box control or column contained in a Looper control Hide the details

<Attribute name>.InitialContent = <Initial content>

<Attribute name>: Character string

Name of the attribute linked to the control whose initial content must be modified. The control linked to the attribute must be a List Box or Combo Box populated programmatically or a column of type "List of values" contained in a Looper control. This parameter has the following format:

<Attribute name>[Row index]

<Initial content>: Character string

List of elements defining the initial content of the object. The elements are separated by CR characters.

Remarks

Limits

The InitialContent property is not available on the columns of Table controls.