<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

Function <Table>.ModifyColumn and Property Modified

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

Subscript of column to modify. The subscript of first column is set to 1.
Subscript equal to -1. The current column is modified. No effect if no column is selected.
Subscript greater than the number of columns in the Table control. A WLanguage error occurs.

<Element row 1>: Optional character strings

First elements of modified column. The values of these elements replace the existing values. 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.
<Table>.ModifyColumn has no effect if none of these parameters is specified.

<Element row N>: Optional character strings

Nth elements of modified column. The values of these elements replace the existing values. 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.
<Table>.ModifyColumn has no effect if none of these parameters is specified.

Remarks

Characteristics of column elements

To modify the value of an element in a column, use the following syntax:

TableName.RowName[ColumnSubscript] = 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 <Source>.Modify,
use <Table>.Display to refresh the Table control.

Function <Table>.ModifyColumn and Property Modified

<Table>.ModifyColumn has no influence on Modified. Modified is used to find out whether the current column was directly modified by the user (direct input in the Table control).

Component: wd260obj.dll