ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Table functions
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
Modifies or returns the visibility status of refresh bar in a Table or TreeView Table control.
This function can be used when the Table control supports the "Pull-to-refresh" option. To enable this option in a Table control:
  1. Open the Table control description window.
  2. In the "Details" tab, in the "Moves and gestures" area, check "Pull to refresh".
  3. Validate.
WINDEV This function is available in WINDEV and is used only in simulator mode. In a WINDEV application, this function has no effect.
Example
// Event "Pull to refresh" of the Table control
// ---------------------------------------------------------
// Check the display of selection bar because the refresh of
// Table control data will be performed in a secondary thread.
// Otherwise, the refresh bar would be automatically hidden at the
// end of process execution.
TableRefreshVisible(TABLE_Data, True)
// Refreshes the data of Table control in a secondary thread
ThreadExécute("ThreadUpdTable", threadNormal, ProcThreadUpdTable)
//----------------------------------------------------
// Procedure used to update the data in the Table control
PROCEDURE ProcThreadTableUpdate()
// Run an HTTP request
HTTPRequest(...)
// Goes back to the main thread to add the request content into the Table control
ExecuteMainThread(ProcUpdTable, HTTPGetResult())
END
// ---------------------------------------------------
// Procedure for filling data in the Table control
PROCÉDURE ProcUpdateTable(sData is string)
// Process the received data in order to populate the Table control
...
// The Table control data is updated, hide the refresh bar
TableRefreshVisible(TABLE_Data, False)
END
Syntax

Changing the state of the refresh bar Hide the details

TableRefreshVisible(<Table control> , <Visible>)
<Table control>: Control name
Name of the control to be used. This control can correspond to:
  • a Table control.
  • a TreeView Table control.
<Visible>: Boolean
  • True to display the refresh bar,
  • False to hide it.

Getting the state of the refresh bar Hide the details

<Result> = TableRefreshVisible(<Table control>)
<Result>: Boolean
  • True if the refresh bar is displayed,
  • False if the refresh bar is hidden.
<Table control>: Control name
Name of the control to be used. This control can correspond to:
  • a Table control.
  • a TreeView Table control.
Remarks
  • During a "Pull to refresh", the refresh bar corresponds to the area displayed above the rows of the Table control during the data refresh.
  • TableRefreshVisible is used for example to check the display of refresh bar when the data found in the Table control is refreshed in a secondary thread. This prevents the application from freezing (the example uses this method).
  • When TableRefreshVisible makes the refresh bar visible, the "Pull to refresh" event of the Table control is not executed.
    Remark: You can force the execution of this event by using ExecuteProcess with the trtPullToRefresh constant.
  • To hide the refresh bar, TableRefreshVisible(False) must be called as many times as TableRefreshVisible(True) was run.
Component: wd290java.dll
Minimum version required
  • Version 20
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help