TableRefreshVisible (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Constants for managing Table, Treeview Table, Looper and List Box controls

FileToMemoryTable

Functions for managing Table controls

TableAddLineWithAnimation

TableCellSelectOccurrence

TableColumnSelect

TableColumnSelectOccurrence

TableDeleteWithAnimation

TableFormulaDeleteAll

TableInsertLineWithAnimation

TableRestorePositionAndSelection

TableSave

TableSavePositionAndSelection

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

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:

Display the description window of Table control.
In the "Details" tab, in the "Moves and gestures" area, check "Pull to refresh". In the "Details" tab, in the "Moves and gestures" area, check "Pull to refresh".
Validate.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Event "Pull to refresh" of the Table control
// ---------------------------------------------------------
// Asks to 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
ThreadExecute("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
PROCEDURE ProcUpdateTable(sData is string)
// Process the received data in order to fill the Table control
...
// The Table control data is updated, hide the refresh bar
TableRefreshVisible(TABLE_Data, False)
END

Syntax

Modifying the visibility status of refresh bar Hide the details

TableRefreshVisible(<Table control> , <Visible>)

<Table control>: Control name

Name of control to use. This control can correspond to:
a Table control.
a TreeView Table control.

<Visible>: Boolean

True to display the refresh bar,
False to hide it.

Finding out the visibility status of 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 control to use. 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 being locked (the example is using this method).
When the refresh bar is made visible by TableRefreshVisible, the event "Refreshing by pull/release" of the Table control is not run.
Note: To force the execution of this event, use ExecuteProcess with the constant trtPullToRefresh.
To hide the refresh bar, TableRefreshVisible(False) must be called as many times as TableRefreshVisible(True) was run.

Component : wd240java.dll