<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

Browsing table: Modifications in the linked data file

Modifications performed in a browsing Table control

<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 browsing or memory Table control.
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 Horizontal Table control to use.

<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))

Browsing table: Modifications in the linked data file

If the cascading input is enabled, the data file linked to the browsing 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 browsing Table control 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 browsing Table control

To modify a column in a browsing Table control, we advise you to:

modify the record in the file with HModify,
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