The column title is an important element of a Table control. Indeed, the title of columns is used to perform operations regarding the appearance (ability to include images) as well as the features (filter, search).

The Table control (and its columns) is now available for the Android applications.

The Table control (and its columns) is now available for the iPhone/iPad applications.

New in version 20

The Table control (and its columns) is now available for the Android applications.

The Table control (and its columns) is now available for the iPhone/iPad applications.

The Table control (and its columns) is now available for the Android applications.

The Table control (and its columns) is now available for the iPhone/iPad applications.

Title of columns

Image for the title of columns

An image can be displayed in the column title. If a caption is displayed in the column title, this image will be positioned on the left of caption. This image can be inserted in the editor or by programming.

To insert an image into the title of a column in the editor:

Display the description window of column ("Description" from the popup menu).

In the "General" tab, specify the image that will be used for the column title. The "Catalog" button allows you to choose an image found in the image catalog of WINDEV.In the "General" tab, specify the image that will be used for the column title via the button:

The "Browse" option is used to select an image file accessible from your computer.

The "Catalog" button is used to choose an image found in the image catalog of WINDEV.

Validate. The image is displayed in the column title in the editor.

To display an image in a column title by programming, use ..TitleImage.

Multiline column title

By default, column title is displayed on a single line. For longer titles, you have the ability to use multiline column titles.

To define a multiline column title:

Display the description window of Table control ("Description" from the popup menu).

In the "Details" tab, check "Multi-line column title".

Validate.

Notes:

The title of columns supports the RTF format and the graphic functions (gXXX functions).

Versions 15 and laterIn the window editor, the height of column titles can be modified with the mouse.

New in version 15In the window editor, the height of column titles can be modified with the mouse.

In the window editor, the height of column titles can be modified with the mouse.

The title of columns can be modified by programming with ..Title or with ..Caption.

Versions 19 and laterThe height of column titles can be modified by programming with ..TitleHeight.

New in version 19The height of column titles can be modified by programming with ..TitleHeight.

The height of column titles can be modified by programming with ..TitleHeight.

Versions 16 and later

Orientation of column title

In a Table control, you have the ability to define a writing angle for the titles (in degrees). This allows you to create slanted column titles.

To slant the title of columns:

Display the description window of Table control ("Description" from the popup menu).

In the "Details" tab, enter "Angle for the title of columns" (in degrees). The arrow button found beside the control is used to precisely select the requested angle.

Display the "Style" tab in the description window of Table control ("Description" from the popup menu).

Select the "Border of column title" element.

Open the "Border" combo box and select "Image (9-image mode)".

Click the "Right arrow" button found to the right of the "Border" combo box. A window for configuring the image of column title is opened.

Select the image of border to use. This image can be selected in the image catalog. The image catalog only proposes the images that can be used as column title.Select the image of border to use by clicking the button:

The "Browse" option is used to select an image file accessible from your computer.

The "Catalog" button is used to choose an image found in the image catalog of WINDEV. The image catalog only proposes the images that can be used as column title.

If the selected image contains several states, specify this number of states.

Close the window for configuring the image of title cells.

Validate.

Note: The "Column title border" element found in the "Style" tab can also be used to configure the height of title area.

Versions 18 and later

Title-header of columns

You have the ability to define a title-header of columns. A title-header of columns is an additional title displayed above the title of one or more columns.

To define a title-header of columns:

Display the "Details" tab in the description window of Table control ("Description" from the popup menu).

Click the "Edit the title-headers of columns" button.

The different table columns are displayed in the window that is opened.

If the title-headers of columns are enabled, the modification of the caption of columns via the description window of the column is ignored: the caption must be modified in the edit window of title-headers of columns.

If the title-headers of columns are enabled, the modification of the caption of columns via the description window of the column is ignored: the caption must be modified in the edit window of title-headers of columns.

If the title-headers of columns are enabled, the modification of the caption of columns via the description window of the column is ignored: the caption must be modified in the edit window of title-headers of columns.

Click the "Sort/Magnifier image" button and select the image that will be used for the magnifier via the button ("Browse" or "Catalog" button).The size of this image must be set to 53 x 33 pixels and the image must contain the following elements:

Image of sortable column: 9 x 8 pixels

Image of sorted column: sorted in ascending order and in descending order (22 x 9 pixels for each drawing)

The different icons displayed in the column title have a specific position:

the icons used to indicate to the user whether the column is sortable, whether the column is sorted and in which direction are displayed on the left.

the icons used to indicate whether a search or a filter can be performed in the column are displayed on the right.

To customize the position of these elements:

Display the description window of column ("Description" from the popup menu).

In the "Style" tab, select the "Border of column title" element.

Click the "Position of Sort/Magnifier Image" image and specify the position of the different icons in relation to the border of the column title.

Default search mode

A column of Table control can allow the user to perform a search or set a filter. You have the ability to choose the operating mode of the Table control columns:

Magnifier mode = Search: When characters are typed by the user in the column header, a search will be automatically performed on the content of column. The rows whose content starts with these characters will be displayed.

Magnifier mode = <Contains> filter: When characters are typed by the user in the column header, a search will be automatically performed on the content of column. The rows whose content contains these characters will be displayed.

To configure the default search mode of the columns in the editor:

Display the description window of Table control ("Description" from the popup menu).

In the "General" tab, specify the requested "Magnifier mode".

Validate.

To configure the default search mode of columns by programming, use ..MagnifierMode. This property allows you to use all the available modes.

Selection bar

Displaying (or not) a selection bar on the column

In a Table control, the selection bar is used to quickly view the selected rows. In some cases, you may want to display the selection bar on some columns only of the Table control.

To avoid displaying the selection bar on some columns in the editor:

Display the description window of column ("Description" from the popup menu).

In the Details tab, uncheck "Display the bar".

Validate.

To avoid displaying the selection bar on some columns by programming, use ..BarVisible.