Home | Sign in | English EN
  • Multiselection List Box control
  • Modified element
  • Miscellaneous
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Stored procedures
Modifies an element in a memory List Box control (standard List Box or ListView) or in a memory Combo Box control.
Remark: ListModify can be used on the single-selection and multiselection List Box controls.
// Modify the element found at subscript 4 in "LIST_CustomerList"
ListModify(LIST_CustomerList, "Moore", 4)
Reports and QueriesUser code (UMC)
// Modify the image found at subscript 4 in "LSV_Diving"
ListModify(LSV_Diving, "Coral Reef", "C:\MyImages\CoralReef.JPG", 4)
ListModify(<List Box control> , <Element> [, <Image> [, <Element subscript>]])
<List Box control>: Control name
Name of the control to be used:
  • List Box control,
  • Combo Box control.If this parameter corresponds to an empty string (""), the element is modified in the List Box control (or Combo Box) to which the current event belongs.
<Element>: Character string (with quotes)
Element to modify in the specified List Box (or Combo Box) control.
Java For a ListView control, this parameter corresponds to the image caption.
PHP The Carriage Return characters (CR) and the tabulations (TAB) are not supported.
<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 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.
PHP This parameter is not available.
<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.
PHP ListModify 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.

Multiselection List Box control

If one or more elements are selected in the List Box control, ListModify deselects no element.
Reports and QueriesJavaUser code (UMC)Ajax

Modified element

When modifying an element containing an invisible value (specified by gLink), gLink must be re-used. Otherwise, this invisible value will be lost during the modification.
For example:
  • adding "MyElement":
    ListAdd(COMBO_MyCombo, "MyElement" + gLink("1"))
  • modifying "MyElement":
    ListModify(COMBO_MyCombo, "MyNewElement" + gLink("1"))


  • To modify an element in a Table control, use TableModify.
  • ListModify can be used on a "Combo Box" table column.
Component: wd260obj.dll
Minimum version required
  • Version 9
This page is also available for…
Exemplo ListModify
ListModify(LIST_List,"Modificando Segundo",2)

// Blog com Video e Exemplo

De matos
04 Dec. 2016