ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Table functions
  • Use conditions
  • Row characteristics
  • Changes in a Table or TreeView Table control based on a data file
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Modifies a row in:
  • a Table control,
  • a TreeView Table control,
Remark: It is recommended to use <Table>.ModifyLine. <Table>.ModifyLine is used to add:
  • TAB characters into the columns,
  • all types of values into the columns.
Example
// Modify the "Paul" and "Moore" elements on the fifth
// row of the "TABLE_CustomerTable" control
TABLE_CustomerTable.Modify("Vince" + TAB + "Moore", 5)
// Modification in a column of a Table control
COL_NAME.Modify("Moore", 5)
Syntax
<Table control>.Modify(<Row> [, <Index>])
<Table control>: Control name
Name of the control to be used. This control can correspond to:
  • a Table control.
  • a TreeView Table control.
<Row>: Character string
Modified row replacing the specified row. This row has the following format:
<Element of column 1> + TAB + <Element of column 2> + TAB + ...
<Index>: Optional integer
Index of the row to be modified. The value of first row is set to 1.
Index not specified or equal to -1The current row is modified. This constant has no effect if no row is selected.
Index greater than the number of control rowsA WLanguage error occurs.
Remarks

Use conditions

<Table>.Modify can be used on:
  • a Table or TreeView Table control based on a data file.
  • a Table or TreeView Table control populated programmatically.
  • a single-selection or multi-selection control.

Row characteristics

  • Each row element is changed into the type of the associated column.
  • If one of the elements corresponds to an empty string ("") or to 0 (depending on the column type), its value will be overwritten.
    For example:
    TABLE_CustomerTable.Modify("Moore" + TAB + "Peter" + TAB + "" + ...
    TAB + "06/21/72")
  • If an element corresponds to the calculation result, the numeric expression must be enclosed in brackets.
    For example:
    TABLE_CalculationTable.Modify((53+29) + TAB + (83-21))
  • To modify the value of an element in a row, use the following syntax:
    TableName.ColumnName[RowIndex] = NewValue

Changes in a Table or TreeView Table control based on a data file

To modify a row in a Table or TreeView Table control based on a data file, we advise you to:
Component: wd290obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/20/2023

Send a report | Local help