ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Table control
  • Default events
  • Optional events
  • Filter records (Table based on a data file only)
  • Before displaying the automatic tooltip of scrollbar
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
Default events
AndroidiPhone/iPad WINDEV and WINDEV Mobile manage the following events by default (order of appearance in the code editor):
EventRuntime condition
InitializationExecuted when the window is opened. (*)

Special case: Table control based on a data file filled automatically
When this code is run, the Table control is not filled yet. To force the Table control to be filled in this code, use:
You can also filter records with HFilter.
End of initializationCode only for automatically populated Table controls based on a data file:

Executed after the Table control has been populated. This code is used to select an element in the Table control, to add or modify an element.
Entry in the Table controlExecuted when the control gains focus.
Exit the Table controlExecuted when moving from one control to another (TAB key, selecting another control with the mouse, etc.).
Entry in edit in a row of the Table controlRun when the user selects a row to perform an input in this row.
Exit a row of the Table controlRun when moving from one row or control to another (TAB key, selecting another control with the mouse, etc.). The Table control must be in edit.
In this code, the current row corresponds to the row that was selected beforehand.
Caution:
  • Table control with Check Box column: simply modifying the check box does not run the row exit code. If a user clicks a check box column, WINDEV does not consider this as entering the row in edit mode . The "Entry in input in a row" and "Exit a row" events are not executed. To manage this case, it is recommended to use the column modification code.
  • Read-only Table control: this code is not executed when moving to another row in a read-only Table control.
Displaying a row of the Table controlRun when a new row must be displayed in the Table control: redisplaying the Table control, scrolling or moving in the Table control, etc, ...

This event is also run when column is assigned. If several columns are assigned through programming, the display code will be run several times.
Tip: To modify several columns, use TableModifyLine rather than the direct assignment.
iPhone/iPad This event is not available in Table controls based on a data file for performance reasons.
Selecting a row of the Table controlRun when the user selects a row (without input).
This event is also run when the user clicks a cell whose selection mode is set to "Single selection" or: Multi-selection".
AndroidiPhone/iPad Pull to refresh
This event is automatically added when the "Pull to refresh" feature is enabled ("Details" tab in the description window of the Table control).
This event is run when a refresh gesture is detected on the Table control.
At the end of this event, the refresh bar will be automatically hidden except if TableRefreshVisible has been called.
iPhone/iPad Filter records (optional event)
Code only for automatically populated Table controls based on a data file:
Run just before displaying a row. This event filters the records displayed in the Table control. This event is detailed at the end of this page.
Code only for Table controls populated programmatically and Table controls based on a variable:
These events are used to simplify the management of programmed Drag and Drops. The available events are:
  • Start drag-and-drop operation.
  • End drag-and-drop operation.
  • Enter drop target.
  • Drag over drop target.
  • Drop on drop target.
  • Leave drop target.
Remark: If one of these events contains some code, the Drag and Drop feature is not automatically managed for Table controls: the Drag and Drop in the Table control must be managed through programming
Scrolling events (optional events)These events make it easy to manage the vertical scrollbar in the control. The available events are:
  • Start scrolling: Executed when the vertical scrollbar of the control starts moving.
  • While scrolling: Executed while the vertical scrollbar of the control moves.
  • Stop scrolling: Executed when the vertical scrollbar of the control stops moving.
Remark: ScrollbarPosition gets the position of the scrollbar.

(*) By default, the "Initialization" event of each control is executed according to the order in which the controls were created in the window. To change this order of execution:
  1. On the "Window" tab, in the "Order" group, click "Initialization".
  2. In the window that appears, use the arrows on the right to change the order in which the controls are initialized.
Optional events
Several optional events are supported. To add an optional event:
  1. Select the desired control.
  2. Display the code window of this control (F2 key).
  3. Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
  4. All the optional events available for the control are displayed.
  5. Check the optional event to add and validate.
    Remark: You can select several optional events.
  6. The selected optional event is automatically added to the events managed by the control.
To disable an optional event, simply perform the same operations to display the list of optional events. Then simply uncheck the optional events to delete.
Remark: If the disabled code contains WLanguage code, this code is automatically deleted.
You can manage the following aspects, for example:
  • the mouse hover over the control,
  • left mouse button down, up, double click,
  • right mouse button down, up, double click,
  • mouse wheel, etc.
Remark: The optional events differ according to the environment (WINDEV, WEBDEV, WINDEV Mobile) and the development platform.
Filter records (Table based on a data file only)
Before displaying the automatic tooltip of scrollbar
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 07/17/2023

Send a report | Local help