ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Queue, stack, list and array functions / Array functions
  • Inserting a column into an advanced array 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
Inserts a column into a given position in an advanced two-dimensional array property (xlsDocument, ...).
Syntax
InsertColumn(<WLanguage array> , <Insertion index> [, <Element row 1> [... [, <Element row N>]]])
<WLanguage array>: Array
Name of the Array variable to use. This variable must correspond to a two-dimensional array.
<Insertion index>: Integer
Subscript where the column must be inserted. From this subscript, all the columns will be shifted by 1 column.
If <Insertion index> 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 InsertColumn is called:
  • 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 as parameter. If no value is passed in parameter, the rows are initialized with the default value of the type of the array elements.
Component: wd290vm.dll
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 04/06/2023

Send a report | Local help