- Multi-selection list box
- Modified element
- Modifying an element in the browser
In French: ListeModifie
Modifies an element in a memory List Box control (standard list box or listview) or in a memory Combo Box control.
Note: ListModify can be used on the single-selection and multi-selection List Box controls.
: The element will be modified on the page displayed in the browser only. See Remarks for more details.
This function is now available for the WINDEV applications in Linux.
// Modify the element found at subscript 4 in "LIST_CustomerList"
ListModify(LIST_CustomerList, "Moore", 4)
ListModify(<List Box Control> , <Element> [, <Image> [, <Element Subscript>]])
<List Box Control>: Control name
Name of control to use:
If this parameter corresponds to an empty string (""), the element is modified in the List Box (or Combo Box) control to which the current process belongs.
- List Box control,
- Combo Box control.
The name of List Box or Combo Box control to use must necessarily be specified.
<Element>: Character string (with quotes)
Element to modify in the specified List Box (or Combo Box) control.
To add several consecutive spaces, non-breakable space characters must be used: Charact(160).
<Image>: Optional character string (with quotes)
Name and path of image that will be added into a ListView control. This parameter is taken into account for the ListView controls displayed in ListView mode only.
If this parameter is not specified, the default image (defined in the "Details" tab in the description window of control) will be used.
<Element Subscript>: Optional integer
Subscript of element to modify.
If this parameter:
- is not specified or if it is set to -1, the current element is modified. ListModify has no effect if there is no current element.
- is equal to 0, the first element is modified.
- is greater than the number of elements found in the List Box (or Combo Box) control, a WLanguage error occurs. The number of elements found in a List Box (or Combo Box) control is returned by ListCount.
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.
Multi-selection list box
If one or more elements are selected in the List Box control, ListModify deselects no element.
When modifying an element containing an invisible value (specified by gLink
must be re-used. Otherwise, this invisible value will be lost during the modification.
- adding "MyElement":
ListAdd(COMBO_MyCombo, "MyElement" + gLink("1"))
- modifying "MyElement":
ListModify(COMBO_MyCombo, "MyNewElement" + gLink("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. In order for this element to be modified on the server, ListModify must be run on the server.
: In "Automatic and immediate AJAX" mode, all you have to do is switch the server process containing ListModify
to automatic AJAX mode. That's it! No additional programming is required. See AJAX
for more details.
- To modify an element in a Table control, use TableModify.
- ListModify can be used on a "Combo box" table column.
This page is also available for…
// Blog com Video e Exemplo