|
|
|
|
|
TableRefreshVisible (Function) In french: TableRafraîchissementVisible 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: - Open the Table control description window.
- In the "Details" tab, in the "Moves and gestures" area, check "Pull to refresh".
- Validate.
// 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.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|