<List Box>.Modify (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / List Box functions

Multi-selection List Box control
Modified element
Modifying an element in the browser
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<List Box>.Modify (Function)

In french: <Liste>.Modifie

Modifies an element in a List Box, ListView or Combo Box control populated programmatically.

Note: The <List Box>.Modify function can be used for both single-selection and multi-selection List Box controls..

Attention: The element will be modified only on the page displayed in the browser. For more details, see Remarks.

Example

// Modification de l'élément situé à l'indice 4 dans le champ Liste "LISTE_ListeClient"
LISTE_ListeClient.Modifie("Dupond", 4)

Syntax

<List Box control>.Modify(<Element> [, <Element index>])

<List Box control>: Control name

Name of control to use:
List Box control,
Combo Box control.

<Element>: Character string

Element to modify in the specified List Box (or Combo Box) control.
The Carriage Return characters (CR) and the tabulations (TAB) are not supported.
To add several consecutive spaces, use non-breaking spaces: Caract(160).

<Element index>: Optional integer

Index of the element to be modified.
If this parameter:
is not specified or if it is set to -1, the current element is modified. <List Box>.Modify has no effect if there is no current element.
is equal to 0, the first element is modified.
is greater than the number of items in the List Box control (or Combo Box control), a WLanguage error is generated.. The number of elements in a List Box (or Combo Box) control is returned by <List Box>.Count.
<List Box>.Modify has no effect if this parameter is equal to 0 or if it is greater than the number of elements found in the List Box (or Combo Box) control.

Remarks

Multi-selection List Box control

If one or more elements are selected in the List Box control, <List Box>.Modify deselects no element.

Modified element

When modifying an element containing an invisible value (specified by gStoredValue), gStoredValue must be re-used. Otherwise, this invisible value will be lost during the modification.

For example:

adding "MyElement":

COMBO_MaCombo.Ajoute("MonElément" + gStoredValue("1"))

modifying "MyElement":

COMBO_MaCombo.Modifie("MonNouvelElément" + gStoredValue("1"))

Modifying an element in the browser

When modifying an element in browser code, this element is modified only for the page displayed in the browser. To make changes to this element on the server as well, <List Box>.Modify must be executed on the server.

Calling <List Box>.Modify in browser code is useful when using AJAX technology, in "Programmed AJAX" mode (via AJAXExecute or AJAXExecuteAsynchronous).

Reminder In "automatic and immediate AJAX" mode, simply pass the server processing containing the function <List Box>.Modify FUNCTION in automatic AJAX mode. That's it! No additional programming is required. For more details, see AJAX.

Miscellaneous

To modify an element in a Table control, use <Table>.Modify.
<List Box>.Modify can be used on a "Combo Box" table column.

Component: wd300obj.dll