ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Table functions
  • Characteristics of column elements
  • Table based on a data file: Modifications in the linked data file
  • Modifications performed in a Table control based on a data file
  • TableModifyColumn function and Modified property
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
TableModifyColumn (Function)
In french: TableModifieColonne
Modifies a column in an "horizontal Table" control.
Remark: TableModifyColumn can be used on:
  • a horizontal Table control based on a data file or populated programmatically.
  • a single-selection or multi-selection Table control.
Syntax
TableModifyColumn(<Table control> , <Index> [, <Element row 1> [... [, <Element row N>]]])
<Table control>: Control name
Name of the Horizontal Table control to be used.
If this parameter corresponds to an empty string (""), the Table control used will be the one to which the current event belongs.
<Index>: Integer
Index of the column to be modified. The index of the first column is set to 1.
Index equal to -1.The current column is modified. No effect if no column is selected.
Index greater than the number of columns in the Table control.A WLanguage error occurs.
<Element row 1>: Optional character string
First element of the first row to be modified in the column. The value of this element replaces the existing value. Each element corresponds to a row in the Table control. Each type of modified element must be compatible with the type of the relevant row.
If none of the <Element row X> parameters are specified, TableModifyColumn has no effect.
<Element row N>: Optional character string
Nth element of the Nth row to be modified in the column. The value of this element replaces the existing value. Each element corresponds to a row in the Table control. Each type of modified element must be compatible with the type of the relevant row.
If none of the <Element row X> parameters are specified, TableModifyColumn has no effect.
Remarks

Characteristics of column elements

  • To modify the value of an element in a column, use the following syntax:
    TableControl.RowName[ColumnIndex] = NewValue
  • If an element corresponds to the calculation result, the numeric expression must be enclosed in brackets. For example:
    TableModifyColumn(TABLE_CalcTable, (53+29),(83-21))

Table based on a data file: Modifications in the linked data file

If the cascading input is enabled, the data file linked to the Table control is automatically modified when the user goes to the next column.
If the cascading input is not enabled, the data file linked to the Table control based on a data file is not modified. To write the record into the data file, TableSave must be run after TableModifyColumn.
Reminder: The "cascading input" option can be selected:
  • When creating a Table control.
  • In the "Details" tab of the description window of Table control in the window editor.

Modifications performed in a Table control based on a data file

To modify a column in a Table control based on a data file, we advise you to:

TableModifyColumn function and Modified property

TableModifyColumn has no influence on the Modified property. The Modified property is used to know if the current column has been directly modified by the user (direct input in the Table control).
Component: wd290obj.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help