InsertColumn (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing queues, stacks, lists and arrays

Inserting a column into an advanced array property

See also

InsertColumn (Function)

In french: InsèreColonne

Inserts a column into a given position in an advanced two-dimensional array property (xlsDocument, ...).

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 19 and later

This function is now available for iPhone/iPad applications.

New in version 19

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Syntax

InsertColumn(<WLanguage array> , <Insertion subscript> [, <Element row 1> [... [, <Element row N>]]])

<WLanguage array>: Array

Name of Array variable to use. This variable must correspond to a two-dimensional array.

<Insertion subscript>: Integer

Subscript where the column must be inserted. From this subscript, all the columns will be shifted by 1 column.
If <Insertion Subscript> is equal to the number of array columns + 1, the column is added at the end of the array (equivalent to AddColumn).
A WLanguage error occurs if <Insertion Subscript> is greater than the number of array columns + 1.

<Element row 1>: Type of array elements, optional

Element of the column that will be inserted into the specified array. Each element corresponds to a row in the array. The type of the added element must be compatible with the type of the relevant row.
If none of these parameters is specified, an empty column is inserted into the array. The rows are initialized with the default value of the type of the other array elements.
If one of these parameters is not specified, the corresponding row is initialized with the default value of the type of the other array elements.

<Element row N>: Type of array elements, optional

Element of the column that will be inserted into the specified array. Each element corresponds to a row in the array. The type of the added element must be compatible with the type of the relevant row.
If none of these parameters is specified, an empty column is inserted into the array. The rows are initialized with the default value of the type of the other array elements.
If one of these parameters is not specified, the corresponding row is initialized with the default value of the type of the other array elements.

Remarks

Inserting a column into an advanced array property

When using InsertColumn:

the advanced variable must be created.
the advanced type must have an enumerator of modifiable collection type.
the advanced type is automatically enlarged to receive the new column.
the rows are initialized with the values passed in parameter. If no value is passed in parameter, the rows are initialized with the default value of the type of the array elements.

Component : wd260vm.dll