PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Events managed by default
  • Optional events
  • Filtering the records (Browsing table 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Events managed by default
WINDEVAndroidiPhone/iPadWindows MobileJava WINDEV and WINDEV Mobile manage the following events by default (order of appearance in the code editor):
EventRuntime condition
InitializationRun when opening the window. (*)

Special case: Browsing table automatically filled
When this code is run, the table is not filled yet. To force the table to be filled in this code, use:Run when opening the window. (*)

Special case: Browsing table automatically filled
When this code is run, the table is not filled yet. To force the table to be filled in this code, use:You also have the ability to filter the records with HFilter.
End of initializationCode found for a browsing table automatically filled only:

Run once the Table control has been filled. This code is used to select an element in the Table control, to add or modify an element.
Entry in the Table controlRun when the control takes focus.
Exit from the Table controlRun 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 from a row of the Table controlRun when moving from one row or control to another (TAB key, selecting another control with the mouse, etc.).
In this code, the current row corresponds to the row that was selected beforehand.
Java In this code, the current row corresponds to the new selected row.
Displaying a row of the Table controlRun when a new row must be displayed in the Table control: redisplay of the Table control, scrolling or movement inside the Table control, ...

This event is also run when column is assigned. If several columns are assigned by 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 browsing Table controls for performance reasons.
Selecting a row of the Table controlRun when the user selects a row (without input).
Versions 16 and later
This event is also run when the user clicks a cell whose selection mode is set to "Single selection" or: Multiselection".
New in version 16
This event is also run when the user clicks a cell whose selection mode is set to "Single selection" or: Multiselection".
This event is also run when the user clicks a cell whose selection mode is set to "Single selection" or: Multiselection".
Versions 20 and later
AndroidiPhone/iPad Pull to refresh
New in version 20
AndroidiPhone/iPad Pull to refresh
AndroidiPhone/iPad Pull to refresh
This event is automatically added when the "Pull to refresh" feature has been 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.
WINDEViPhone/iPadWindows MobileJava Filtering the records (optional event)
Code only for browsing Table controls filled automatically:
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.
WINDEVWindows Mobile Drag and Drop management events (optional events)
Code only for memory and source Table controls::
These events are used to simplify the management of programmed Drag and Drops. The available events are:
  • Beginning of source drag/drop.
  • End of source drag/drop.
  • Entry in target drag/drop.
  • Rollover in target drag/drop.
  • Drop in target drag/drop.
  • Exit from target drag/drop.
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 by programming

(*) By default, the "Initializing" event of each control is run according to the order in which the controls were created in the window. To modify this runtime order:
  1. Select "Windows .. Edit the initialization order".On the "Window" pane, in the "Order" group, click "Initialization".
  2. In the window that is displayed, use the arrows on the right to modify the initialization order of controls.
WEBDEV - Server codeWEBDEV - Browser codePHP WEBDEV manages the following events by default (order of appearance in the code editor):
EventRuntime condition
Initialization (Server code)Run when opening the page.
Special case: Browsing Table control filled automatically:
When this code is run, the Table control is not filled yet. To force the control to be filled in this code, use:
You also have the ability to filter the records with HFilter.
End of initialization (Server code)Code only found for a browsing Table control that is automatically filled:
Run once the Table control has been filled. 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 in AJAX mode
Run when the user selects a row (without input).
Versions 19 and later
Table in Browser mode
Run when the user selects a row (without input)
New in version 19
Table in Browser mode
Run when the user selects a row (without input)
Table in Browser mode
Run when the user selects a row (without input)
Row display (Server code)Run when a new row must be displayed in the Table control: redisplaying the Table control, scrolling or moving in the Table control, etc.
Used to manage the calculated columns.
Versions 19 and later
Row display (Browser code)
New in version 19
Row display (Browser code)
Row display (Browser code)
Versions 19 and later
Table in Browser mode only
Run when a new row must be displayed in the Table control: redisplaying the Table control, scrolling or moving in the Table control, etc.
New in version 19
Table in Browser mode only
Run when a new row must be displayed in the Table control: redisplaying the Table control, scrolling or moving in the Table control, etc.
Table in Browser mode only
Run when a new row must be displayed in the Table control: redisplaying the Table control, scrolling or moving in the Table control, etc.
Table click (Browser code)Run when the Web user selects a row.
Exit from a row (Server code)Table in AJAX mode only
Run when moving from one row or control to another (TAB key, selecting another control with the mouse, etc.)
Filtering the records (Server code)Code only for browsing Table controls filled automatically:
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 managed.
To manage an optional event, simply select it in the icon bar of the code window.
WINDEV and WINDEV Mobile (Windows Mobile projects)
WINDEV and WINDEV Mobile (Windows Mobile projects)
WEBDEV
WEBDEV
To add an optional event:
  1. Select the requested control.
  2. Display the code window of this control (F2 key).
  3. Click the link "Add other processes to xxx" at the bottom of the window code, after the last event.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: 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.
Note: If the disabled code contains WLanguage code, this code is automatically deleted.
You can manage, for example:
  • the control rollover with the mouse,
  • the left mouse button down, up, with a double click,
  • the right mouse button down, up, with double click,
  • the mouse wheel, etc.
Remark: The optional events differ according to the environment (WINDEV, WEBDEV, WINDEV Mobile) and the development platform.
Filtering the records (Browsing table only)
WINDEVWEBDEV - Server codeWindows MobilePHP The event "Filtering the records" is run right 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 event "Filtering the records" 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:
// -- Filtering records
// Displays the customers who placed orders exceeding 3000 Euros
IF Orders.TotalIOT >=3000 THEN
RESULT True
ELSE
RESULT 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.
WINDEVWINDEV Mobile If an automatic filter is implemented on the Table control (TableEnableFilter or filter enabled by the user directly), the filter defined by the event "Filtering the records" is combined with the automatic filter.
Remark: In WINDEV and WINDEV Mobile, the event "Recording the records" is an optional event. In WEBDEV, this event is proposed by default.
Before displaying the automatic tooltip of scrollbar
Versions 17 and later
WINDEV In Windows, the tooltip for the scrollbar in a Table control is displayed when the user clicks the "box" of the vertical scrollbar.
This tooltip contains the following information by default:
  • Range of rows currently displayed in the Table control.
  • Total number of rows in the Table control.
  • Information about the element currently displayed in the first row of the Table control in the sorted column.
The event "Before displaying the automatic tooltip of the scrollbar" is run just before the tooltip is displayed. You can for example display a specific text in the table tooltip via ..ToolTip.
New in version 17
WINDEV In Windows, the tooltip for the scrollbar in a Table control is displayed when the user clicks the "box" of the vertical scrollbar.
This tooltip contains the following information by default:
  • Range of rows currently displayed in the Table control.
  • Total number of rows in the Table control.
  • Information about the element currently displayed in the first row of the Table control in the sorted column.
The event "Before displaying the automatic tooltip of the scrollbar" is run just before the tooltip is displayed. You can for example display a specific text in the table tooltip via ..ToolTip.
WINDEV In Windows, the tooltip for the scrollbar in a Table control is displayed when the user clicks the "box" of the vertical scrollbar.
This tooltip contains the following information by default:
  • Range of rows currently displayed in the Table control.
  • Total number of rows in the Table control.
  • Information about the element currently displayed in the first row of the Table control in the sorted column.
The event "Before displaying the automatic tooltip of the scrollbar" is run just before the tooltip is displayed. You can for example display a specific text in the table tooltip via ..ToolTip.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment