The browsing Table control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview
Notes
Limitations for Android
Limitations for iOS
Browsing table with direct access and Browsing table loaded in memory
Types of browsing Table controls
Limit in Java: Cascading input
Automatic synchronization (HFSQL Client/Server data)
Automatic viewing of bound records
Implementation via the window editor (automatic mode)
Implementation via the window editor (custom mode)
Implementation by programming

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

The browsing Table control

Not available with this kind of connection

Overview

A browsing Table control is a control whose columns are bound to items in a data file or query (data source). Each Table control column can be:

Bound to an item of the data source
Bound to an item of a data file related to the data source
Calculated: If the column is not bound to a data file item, then it is a calculated column. For calculated columns, the content of the column is recalculated each time a row is displayed.

Each row in the Table control corresponds to a record of the data source.

A browsing table control is used to:

View the content of a data file (or query) with one record per row and select a record (view the entire file or a selection of records selected according to a filter).
Versions 23 and later
View the content of bound records (for example, view the order lines associated with an order displayed in the Table control).
New in version 23
View the content of bound records (for example, view the order lines associated with an order displayed in the Table control).
View the content of bound records (for example, view the order lines associated with an order displayed in the Table control).
Delete a record by deleting a row from the Table control.
Modify a record by modifying the content of a row found in the Table control.
Add a record by entering a row in the Table control.
Versions 23 and later
Automatically refresh the data modified from another computer.
New in version 23
Automatically refresh the data modified from another computer.
Automatically refresh the data modified from another computer.

The number of records that can be viewed is unlimited, only the visible rows of Table control are loaded in memory.

Remark: When creating a non-Ajax browsing Table control, a pager is automatically associated with this control. This pager is used to display the records found in the Table control.

Versions 20 and later

The browsing Table control is now available for Android applications.

The browsing Table control is now available for iPhone/iPad applications.

New in version 20

The browsing Table control is now available for Android applications.

The browsing Table control is now available for iPhone/iPad applications.

The browsing Table control is now available for Android applications.

The browsing Table control is now available for iPhone/iPad applications.

Notes

The browsing Table controls are used mainly to view data. To enter data, use the edit controls.
The row selected in the Table control corresponds to the current record in the data file. When changing row in the Table control, the current record in the data file is automatically modified.

Limitations for Android

Data input is not available in browsing Table controls. TableAdd, TableAddLine, TableInsert, TableInsertLine, TableModify and TableModifyLine are not available on browsing Table controls.
Only the automatic browse is available for browsing Table controls. The programmed browse is not available.
The browsing Table controls loaded in memory are not limited.

Limitations for iOS

The Table controls are available in read-only: data input is not available in this version.

Browsing table with direct access and Browsing table loaded in memory

Types of browsing Table controls

Two types of browsing Table controls are available:

The browsing Table controls based on the file in direct access. These are the "standard" browsing Table controls.
The browsing Table controls based on a file loaded in memory. Only a specific number of file records (specified in the editor) are loaded in memory. These browsing Table controls are mainly used to perform sorts and searches on any column.
You cannot define the number of records loaded in memory.

See Comparison between the features of Table controls for more details.

Limit in Java: Cascading input

In Java, the cascading input is not available for the browsing Table controls with direct access. The cascading input is available for the browsing table controls loaded in memory only.

Versions 23 and later

Automatic synchronization (HFSQL Client/Server data)

A browsing Table control can be automatically refreshed, as soon as the associated HFSQL Client/Server data file is modified. This feature can be implemented:

in the editor:
1. Open the browsing Table control description window.
2. In the "Content" tab, select the synchronization mode of display:
  - Never: No synchronization is performed (default case).
  - Modification only: The synchronization is performed when modifying a record.
  - Addition/Deletion only: The synchronization is performed when adding or deleting a record
  - Always: The synchronization is performed as soon as a write or delete operation is performed in the data file.
3. Validate.
by programming: via the SynchroHFSQL property that can be used on the browsing Table control.

Automatic synchronization takes place:

between the different instances of the same application on a computer or different computers,
between different applications on a computer or different workstations
between the different windows of the same application, whether or not the HFSQL context is the same between the windows.

Caution: Enabling this feature increases the server load when displaying the Table control or when moving in the control.

New in version 23

Automatic synchronization (HFSQL Client/Server data)

A browsing Table control can be automatically refreshed, as soon as the associated HFSQL Client/Server data file is modified. This feature can be implemented:

in the editor:
1. Open the browsing Table control description window.
2. In the "Content" tab, select the synchronization mode of display:
  - Never: No synchronization is performed (default case).
  - Modification only: The synchronization is performed when modifying a record.
  - Addition/Deletion only: The synchronization is performed when adding or deleting a record
  - Always: The synchronization is performed as soon as a write or delete operation is performed in the data file.
3. Validate.
by programming: via the SynchroHFSQL property that can be used on the browsing Table control.

Automatic synchronization takes place:

between the different instances of the same application on a computer or different computers,
between different applications on a computer or different workstations
between the different windows of the same application, whether or not the HFSQL context is the same between the windows.

Caution: Enabling this feature increases the server load when displaying the Table control or when moving in the control.

Automatic synchronization (HFSQL Client/Server data)

A browsing Table control can be automatically refreshed, as soon as the associated HFSQL Client/Server data file is modified. This feature can be implemented:

in the editor:
1. Open the browsing Table control description window.
2. In the "Content" tab, select the synchronization mode of display:
  - Never: No synchronization is performed (default case).
  - Modification only: The synchronization is performed when modifying a record.
  - Addition/Deletion only: The synchronization is performed when adding or deleting a record
  - Always: The synchronization is performed as soon as a write or delete operation is performed in the data file.
3. Validate.
by programming: via the SynchroHFSQL property that can be used on the browsing Table control.

Automatic synchronization takes place:

between the different instances of the same application on a computer or different computers,
between different applications on a computer or different workstations
between the different windows of the same application, whether or not the HFSQL context is the same between the windows.

Caution: Enabling this feature increases the server load when displaying the Table control or when moving in the control.

Versions 23 and later

Automatic viewing of bound records

In a browsing table, you can expand a row to see the records of other data files that are bound to the selected row.

Example:

Implementation via the window editor (automatic mode)

To allow the user to expand rows in a browsing Table control to see the bound records:

Open the browsing Table control description window.
In the "Content" tab, check "Display a [ + ] for row details".

The setting window is automatically displayed.
In the setting window:
- Check (if necessary) "Enable display of bound data".
- Select the "Automatic" display mode. In this mode, all the bound data files are proposed by the user.
- Validate.
Validate the Table control description window.

When running the Table control, a popup menu allows the user to display the data bound to the data file currently displayed in the browsing Table control.

Remark: the image of "+" displayed at the beginning of line can be customized:

Open the browsing Table control description window.
In the "Style" tab:
- Select "[+]/[-] image IW for row details".
- Click the "Plus/Minus image of detailed Internal Window" button.
- Select the image corresponding to the button and validate.

Implementation via the window editor (custom mode)

To allow the user to expand rows in a browsing Table control to see the bound records:

Open the browsing Table control description window.
In the "Content" tab, check "Display a [ + ] for row details". The configuration window is automatically displayed.
In the setting window:
- Check (if necessary) "Enable display of bound data".
- Select the "Manual" display mode. In this mode, only the data found in a data file is proposed by the user. You have the ability to customize the data displayed.
- Select the source item, found in the file displayed by the Table control.
- Select the bound item in the bound data file.
- Select the items that will be displayed in the table of bound data. The "+" and "-" buttons are used to manage the data to display.
- Validate.
Validate the Table control description window.

When running the Table control, a "+" sign allows the user to display the data bound to the data file currently displayed in the browsing Table control.

Remark: the image of "+" displayed at the beginning of line can be customized:

Open the browsing Table control description window.
In the "Style" tab:
- Select "[+]/[-] image IW for row details".
- Click the "Plus/Minus image of detailed Internal Window" button.
- Select the image corresponding to the button and validate.

Implementation by programming

To allow the user to expand rows in a browsing Table control to see the bound records:

Create a browsing Table control based on a data file or query.
In the Table control initialization code, use the RowDetailsBinding property.

New in version 23

Automatic viewing of bound records

In a browsing table, you can expand a row to see the records of other data files that are bound to the selected row.

Example:

Implementation via the window editor (automatic mode)

To allow the user to expand rows in a browsing Table control to see the bound records:

Open the browsing Table control description window.
In the "Content" tab, check "Display a [ + ] for row details".

The setting window is automatically displayed.
In the setting window:
- Check (if necessary) "Enable display of bound data".
- Select the "Automatic" display mode. In this mode, all the bound data files are proposed by the user.
- Validate.
Validate the Table control description window.

When running the Table control, a popup menu allows the user to display the data bound to the data file currently displayed in the browsing Table control.

Remark: the image of "+" displayed at the beginning of line can be customized:

Open the browsing Table control description window.
In the "Style" tab:
- Select "[+]/[-] image IW for row details".
- Click the "Plus/Minus image of detailed Internal Window" button.
- Select the image corresponding to the button and validate.

Implementation via the window editor (custom mode)

To allow the user to expand rows in a browsing Table control to see the bound records:

Open the browsing Table control description window.
In the "Content" tab, check "Display a [ + ] for row details". The configuration window is automatically displayed.
In the setting window:
- Check (if necessary) "Enable display of bound data".
- Select the "Manual" display mode. In this mode, only the data found in a data file is proposed by the user. You have the ability to customize the data displayed.
- Select the source item, found in the file displayed by the Table control.
- Select the bound item in the bound data file.
- Select the items that will be displayed in the table of bound data. The "+" and "-" buttons are used to manage the data to display.
- Validate.
Validate the Table control description window.

When running the Table control, a "+" sign allows the user to display the data bound to the data file currently displayed in the browsing Table control.

Remark: the image of "+" displayed at the beginning of line can be customized:

Open the browsing Table control description window.
In the "Style" tab:
- Select "[+]/[-] image IW for row details".
- Click the "Plus/Minus image of detailed Internal Window" button.
- Select the image corresponding to the button and validate.

Implementation by programming

To allow the user to expand rows in a browsing Table control to see the bound records:

Create a browsing Table control based on a data file or query.
In the Table control initialization code, use the RowDetailsBinding property.

Automatic viewing of bound records

In a browsing table, you can expand a row to see the records of other data files that are bound to the selected row.

Example:

Implementation via the window editor (automatic mode)

To allow the user to expand rows in a browsing Table control to see the bound records:

Open the browsing Table control description window.
In the "Content" tab, check "Display a [ + ] for row details".

The setting window is automatically displayed.
In the setting window:
- Check (if necessary) "Enable display of bound data".
- Select the "Automatic" display mode. In this mode, all the bound data files are proposed by the user.
- Validate.
Validate the Table control description window.

When running the Table control, a popup menu allows the user to display the data bound to the data file currently displayed in the browsing Table control.

Remark: the image of "+" displayed at the beginning of line can be customized:

Open the browsing Table control description window.
In the "Style" tab:
- Select "[+]/[-] image IW for row details".
- Click the "Plus/Minus image of detailed Internal Window" button.
- Select the image corresponding to the button and validate.

Implementation via the window editor (custom mode)

To allow the user to expand rows in a browsing Table control to see the bound records:

Open the browsing Table control description window.
In the "Content" tab, check "Display a [ + ] for row details". The configuration window is automatically displayed.
In the setting window:
- Check (if necessary) "Enable display of bound data".
- Select the "Manual" display mode. In this mode, only the data found in a data file is proposed by the user. You have the ability to customize the data displayed.
- Select the source item, found in the file displayed by the Table control.
- Select the bound item in the bound data file.
- Select the items that will be displayed in the table of bound data. The "+" and "-" buttons are used to manage the data to display.
- Validate.
Validate the Table control description window.

When running the Table control, a "+" sign allows the user to display the data bound to the data file currently displayed in the browsing Table control.

Remark: the image of "+" displayed at the beginning of line can be customized:

Open the browsing Table control description window.
In the "Style" tab:
- Select "[+]/[-] image IW for row details".
- Click the "Plus/Minus image of detailed Internal Window" button.
- Select the image corresponding to the button and validate.

Implementation by programming

To allow the user to expand rows in a browsing Table control to see the bound records:

Create a browsing Table control based on a data file or query.
In the Table control initialization code, use the RowDetailsBinding property.

Related Examples:

Mobile (WINDEV Mobile): Pocket Attendance

[ + ] This application is an attendance manager. It allows you to list the persons who attended a meeting.
The database is previously filled with the list of registered persons.
A bar code reader can be used to read the identifiers of the persons.
The following topics are presented in this example:
1/ the click performed on a table column
2/ the use of a browsing table