<Table>.ModifyColumn (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

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

<Table>.ModifyColumn function and Modified property

See also

<Table>.ModifyColumn (Function)

In french: <Table>.ModifieColonne

Modifies a column in an "horizontal Table" control.

Remark: <Table>.ModifyColumn can be used on:

a horizontal Table control based on a data file or populated programmatically.
a single-selection or multi-selection Table control.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Syntax

<Table control>.ModifyColumn(<Subscript> [, <Element row 1> [... [, <Element row N>]]])

<Table control>: Control name

Name of the Horizontal Table control to be used.

<Subscript>: 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, <Table>.ModifyColumn 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, <Table>.ModifyColumn 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:

TABLE_CalculationTable.ModifiyColumn((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, <Table>.Save must be run after <Table>.ModifyColumn.

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:

modify the record in the file with <Source>.Modify,
use <Table>.Display to refresh the Table control.

<Table>.ModifyColumn function and Modified property

<Table>.ModifyColumn 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: wd270obj.dll