ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
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
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Default events
WEBDEV - Server codeWEBDEV - Browser codePHP The following events appear by default in the WEBDEV code editor:
EventRuntime condition
Initialization (Server code)Executed when the page is opened.
Special case: Table control based on a data file field filled automatically.:
When this code is run, the Table control is not filled yet. To force the control to be populated in this event, use:
You can also filter records with HFilter.
End of initialization (Server code)Code 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.
Row selection (Server code)Code run when the user selects a row in the Table control.
Row selection (Browser code)Table control in "Server + AJAX" mode
Executed when the user selects a row (without input).
Table control in "Browser" mode
Executed when the user selects a row (without input)
Row display (Server code)Executed when a new line is to be displayed in the Table control: redisplay of the Table control, scrolling or moving within the Table control, etc.
Used to manage the calculated columns.
Row display (Browser code)Table control in "Browser" mode only
Executed when a new line is to be displayed in the Table control: redisplay of the Table control, scrolling or moving within the Table control, etc.
Table click (Browser code)Executed when the Web user selects a row.
Exit a row (Server code)Table control in "Server + AJAX" mode only
Executed when a line is changed or when a field is changed (TAB key, mouse field change, etc.) from a line
Filter records (Server code)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.
Optional events
Several optional events can be added. 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.
    Note: Several optional events can be selected.
  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.
Note: If the deactivated code contains WLanguage code, this code is automatically deleted..
For example, you can use the following events:
  • the mouse hover over the control,
  • left mouse button down, up, double click,
  • right mouse button down, up, double click,
  • the mouse wheel, etc.
Remark: Depending on the environment (WINDEV, WEBDEV, WINDEV Mobile) and the development platform, the optional events available are not the same.
Filter records (Table based on a data file only)
WEBDEV - Server codePHP The "Filter records" event is executed after a row of the Table control is displayed. Therefore, it is run:
  • when initializing the Table control.
  • whenever a row is displayed in the Table control.
This event filters the records displayed in the Table control.
To implement a filter, the "Filter records" event must return a value:
  • True to specify that the record matches to the filter and that it must be displayed.
  • False to specify that the record does not match the filter and that it must not be displayed.
  • Cancel to stop reading the data source of the table (very rare case).
Example:
// -- Filter the records
// Displays the customers who placed orders exceeding 3000 Euros
IF Orders.TotalIOT >=3000 THEN 
	RETURN True
ELSE
	RETURN False
END
In this code, the data used affects the record currently read by the Table control. This data comes from the data file or query linked to the Table control.
Note: In WINDEV and WINDEV Mobile, the "Record filtering" event is optional.. In WEBDEV, this event is proposed by default.
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: 01/16/2025

Send a report | Local help