ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Table control
  • Overview
  • Resizing columns
  • Tip
  • Automatically adjusting the column size
  • Changing the order of columns
  • Tip
  • Freezing columns
  • Performing a search in the columns
  • Tip
  • Displaying the column content on several lines
  • Copying the column
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 Table controls displayed in a window allow the end user to perform several operations. Some features are automatic, while others require simple changes in the application.
This help page presents the Automatic Application Features (AAF) available for columns in Table controls:
Remark: These Automatic Application Features (AAF) are also available for the TreeView Table controls.
Resizing columns
The user can easily resize the columns found in a Table control.
To resize the columns found in a Table control:
  1. Hover the column separator.
  2. When the cursor tuns into a double arrow, keep the left mouse button down.
  3. Move the column separator to get the desired width.
Example:
The first column is too small to to see the entire name of companies.
The first column is too small to
to see the entire name of companies.
The first column was enlarged.
The first column was enlarged.

Tip

To automatically adjust the size of the column to the longest text it contains, simply double-click the column separator (to the right of the title of the desired column).
Remark: To make automatic adjustment available, check the "Resizable" option in the "General" tab of the column description.
Automatically adjusting the column size
At any time, the user can make the columns of a Table control fit their content.
To make the columns of a Table control fit to the content:
  1. Right-click the column title. A context menu appears. This context menu is related to the current column.
  2. Select "Adjust all columns".
  3. Columns automatically resize to fit their content.
Remark: To make automatic adjustment available, check the "Resizable" option in the "General" tab of the column description.
Changing the order of columns
The end user can easily reorganize the columns in a Table control. To do so, the following operations must be performed:
  1. Click the title of the column to move, and keep the left mouse button down.
  2. Move the column to its new position and release the left mouse button.
Example: In this example, the NAME column moves before the COMPANY column:

Tip

To implement this feature, "Movable" must be checked in the "General" tab of the column description.
Freezing columns
You can freeze a column so that its content remains visible: the column is fixed on the border of the Table control and the horizontal scrollbar is used to access (if necessary) the other columns of the Table control.
You can freeze or unfreeze the columns of a table:
  • with the mouse:
    1. Hover over the left side of the title of the last column to be fixed.
    2. When the mouse cursor turns into an opened padlock, click with the left mouse button. The selected column and all columns to the left of this column will be fixed. These columns will remain fixed.
    To unfreeze columns, follow the same steps.
  • with the context menu of the column:
    1. Right-click the title of the column to be fixed. A context menu appears. This context menu is related to the current column.
    2. To freeze the column, select "Freeze column to the left". A checkmark appears to the left of the option. The selected column and all columns to the left of this column will be fixed. These columns cannot be moved anymore..
    3. To unfreeze the columns, open the context menu of a fixed column and uncheck "Freeze columns to the left". The checkmark no longer appears. The selected column and all columns to the right of this column will no longer be fixed.
Example:
The Name column has been fixed. The Company and Name columns can no longer be moved
The Name column has been fixed. The Company and Name columns can no longer be moved
Tip: To add this feature, check the "Resizable" option in the "General" tab of the column description.
Performing a search in the columns
To perform a search in a Table control, you must:
  1. Click the magnifier in the column title. An input area is displayed.
  2. Enter the first letters of the search item. The first corresponding element is automatically selected in the Table control.
Remarks:
  • To add this feature, check "Magnifier (search/filter)" in the "General" tab of the column description.
  • You also have the ability to filter the elements displayed in a Table control. For more details, see Filter in the columns of a Table control.

Tip

You can also search as you type. Simply:
  1. Sort the column where the search must be performed (this column must have a search icon).
  2. Enter the first letters of the search item. The first matching element is automatically selected in the table.
Displaying the column content on several lines
In some cases, columns are too narrow to display the all the information. The column must be enlarged. But in some cases, the column becomes as wide as the table itself!
To avoid these operations, use the context menu of the column:
  1. Right-click the column title. A context menu appears. This context menu is related to the current column.
  2. Select "Display over several lines".
  3. The column content is automatically displayed on several lines.
Remarks:
  • The content of the table column must contain space characters in order to be displayed on several lines.
  • To display all the text columns as multiline columns, check "Multiline text columns" in the "Details" tab of the description window of Table control.
  • Like with all the AAF context menus, you can configure the default options available in the Table control. For more details, see Configuring the AAF menus.
  • Programmatically:
    • AAFDisable deletes the menu option when used with the aafDisplayOnSeveralLines constant.
    • when the Multiline property is used on a column, it allows you to know whether the column is displayed in multiline mode.
Copying the column
To copy the data found in a column of a Table control:
  1. Right-click the column title. A context menu appears. This context menu is related to the current column.
  2. Select "Copy the column".
  3. The column content is automatically copied into the clipboard and it can be pasted in any application.
Remark: Like with all the AAF context menus, you can configure the default options available in the Table control. For more details, see Configuring the AAF menus.
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 10/04/2022

Send a report | Local help