TableMoveColumn (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Table functions

Use conditions
The different types of column indices
Move and anchor columns
Moving columns in horizontal Table controls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TableMoveColumn (Function)

In french: TableDéplaceColonne

Moves a column in a Table or TreeView Table control.

Remarks:

To move a row in a Table control, use TableMoveLine.
This function is equivalent to the following operation performed at runtime: click the header of a column and move the column while keeping the left mouse button down.

Example

// Move the "COL_ProductPrice" column
// on the far left side in the "TABLE_ProductTable" control
TableMoveColumn(TABLE_ProductTable, COL_ProductPrice, 1)

Syntax

TableMoveColumn(<Table control> , <Column> , <Index of destination column>)

<Table control>: Control name

Name of the control to be used. This control can correspond to:
a Table control.
a TreeView Table control.
If this parameter corresponds to an empty string (""), the control to which the current event belongs will be used.

<Column>: Control name

Name of the column to move. The column name is returned by TableEnumColumn.

<Index of destination column>: Integer

New position of the column in the control. The first column (even if it is invisible) is column #1.

Remarks

Use conditions

TableMoveColumn can be used on:

a Table or TreeView Table control based on a data file.
a Table or TreeView Table control populated programmatically.
a single-selection or multiselection control.

This function is available for Table controls in "Server" and "Server + AJAX" mode, and for TreeView Table controls.

This function is available for Table controls in "Browser" mode only. The TreeView Table control is not available.

The different types of column indices

There are 2 types of indices for columns:

Index of the visible position: index of the column at runtime.
Creation index: index of the column when creating the Table control in the editor.

These indices change if the user moves the columns.

TableMoveColumn uses the index of the visible position.

Move and anchor columns

If the column is moved among some anchored columns, this column automatically becomes anchored.
If the column is moved outside the anchored columns, this column is not anchored anymore.

Moving columns in horizontal Table controls

If TableMoveColumn is called on a horizontal Table control, the rows will be moved.
To move the columns in a horizontal Table control, use TableMoveLine.

Business / UI classification: UI Code

Component: wd280obj.dll