ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Table Column control
  • Overview
  • Characteristics of the columns in a Table control in a window
  • Image of column title
  • Resize column
  • Sortable column
  • Movable column
  • Search (Search icon / Filter)
  • Fixed column, anchored column
  • Progress Bar column
  • Description
  • Progress bar with a different upper bound for each row of the Table control
  • Properties that can be used on a Progress Bar cell
  • Calculated column and Check Box column (Table control populated programmatically and with in-memory data source)
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
Overview
The columns are used to display information in a Table control. The same type of information is displayed in the same column.
The following types of data can be displayed in a column:
  • Text
  • Currency
  • Time
  • Combo Box
    AndroidiPhone/iPad Not available.
  • Image
  • Progress Bar
  • Numeric
  • Date
  • Caption
  • Check Box
    AndroidiPhone/iPad Not available.
  • Duration
    Android Not available.
  • Container
    (not available in Java and in WINDEV Mobile)
Remark: To call gImage in a column, use a Text column.
Specific characteristics can be configured for each type of column.
The programming of each type of column corresponds to the programming of the corresponding control.
The following paragraphs present the main characteristics of the Table control columns displayed in a window, available regardless of the column type. For the columns of Table controls displayed in a page, see Characteristics of the columns of a Table control in a page.
Characteristics of the columns in a Table control in a window
Most characteristics of the columns found in a Table control are configured in the "General" tab of the characteristics of each column.
Characteristics of columns

Image of column title

This option allows you to define the image that will be used as the background image of the column title.
AndroidiPhone/iPad Table control columns cannot have an image in the column title.

Resize column

If a column is resizable:
  • The user can change the size of the columns with the mouse.
  • This column will be automatically resized with the "Adjust all columns" option in the context menu of the column header.
Programming:
  • You can resize columns using <Table>.Adjust.
  • You can make columns resize to fit their content by using AAFExecute with the aafAdjustAllColumns constant.

Sortable column

The user will be able to sort the column via a click performed on its header. This option is available:
  • for all columns in a Table or TreeView Table control populated programmatically.
  • for some columns in the Table control based on a data file (only columns based on key items and without filter).


Remark: At runtime, the Ascending sort and Descending sort icons indicate the sort direction of the column. You can customize the images used. For more details, see Configuring the titles of the columns found in a Table control.
Programming: The sort can also be performed through programming via the following functions:
<Table>.SortUsed to sort the content of a Table or TreeView Table control on one or more columns
<TreeView Table>.SortChildUsed to sort a branch of a TreeView Table control on one or more columns (lexicographical sort).

The SortOption property allows you to define the sorting options.

Movable column

The user will be able to move the column in the Table control and to change the order in which the columns are displayed.
AndroidiPhone/iPad The columns of the Table control cannot be moved.

Search (Search icon / Filter)

The user will be able to implement a "Starts with" filter in the column. Only the elements starting with the letters typed for the column will be displayed.
AndroidiPhone/iPad The user clicks the column header to open the context menu.
  • In the context menu, the user selects the search icon:
    Search icon
  • In the input area that is displayed at the top of the Table control, the user types the sought word.
    Edit the search
The search icon is available:
  • for all the columns in a Table control populated programmatically.
  • for the columns of Table controls based on a data file with automatic iteration (only sortable columns based on key items, and without filter).
Caution: The search icon is not available:
  • for items associated with a multi-file link.
  • for the Table controls that use a non-proportional scrollbar ("Proportional scrollbar" unchecked in the "Details" tab of the description window of the Table control).
Programming: This feature can be performed through programming via the following functions:
<TreeView Table column>.SearchChildSearches for a value in a column of a TreeView Table control, in a specified branch.
TableSearchSearches for a value in a column of a Table or TreeView Table control based on a data file or populated programmatically.

Fixed column, anchored column
Progress Bar column
AndroidiPhone/iPad

Description

The configuration of the progress bar is performed in the "General" tab of the column description. You can configure:
  • the initial value of the progress bar,
  • the maximum value of progress bar,
  • the active image and the background image.
The "Details" tab of the column description is used to configure the display of the progress percentage, ...
AndroidiPhone/iPad

Progress bar with a different upper bound for each row of the Table control

You have the ability to display a progress bar with a different upper bound for each row. In this case, you must:
  1. Assign the MaxValue property to 100 for the column.
  2. Perform the desired calculation in the display code of the row:
    <Progress Bar column> = <Value of Progress Bar>*100/<Max Value>
AndroidiPhone/iPad

Properties that can be used on a Progress Bar cell

You can use the MaxValue and MinValue properties on the Progress Bar cells using the following syntax:
<Column name>[<Row number>].MaxValue = <Value>
<Column name>[<Row number>].MinValue = <Value>
Calculated column and Check Box column (Table control populated programmatically and with in-memory data source)
Related Examples:
Style for displaying the table cells Unit examples (WINDEV): Style for displaying the table cells
[ + ] Modifying the display style of table cells.
The ..BrushStyle property is used to hatch the cells or to create a color gradient with "tube" effect.
Custom Calculations Unit examples (WINDEV): Custom Calculations
[ + ] Using a formula entered by the user in a Table control.
The formula is entered in the column and stored in a .INI file in order to be used whenever the table is displayed. The formula can be modified at any time by the user.
The Table/TreeView Table control (Progress Bar columns) Unit examples (WINDEV): The Table/TreeView Table control (Progress Bar columns)
[ + ] Using a Progress Bar column as well as the ..TextProgressBar property in a Table or TreeView Table control
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help