<Table>.RefreshVisible (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Table>.RefreshVisible (Function)

In french: <Table>.Rafraî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.

This function is available in WINDEV only in order to be used in simulator mode. Used in a WINDEV application, this function has no effect.

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

// "Pull to refresh" process of 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.
TABLE_Data.RefreshVisible(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
PROCÉDURE 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
TABLE_Data.RefreshVisible(False)
END

Syntax

Modifying the visibility status of refresh bar Hide the details

<Table control>.RefreshVisible(<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> = <Table control>.RefreshVisible()

<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.
<Table>.RefreshVisible 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 <Table>.RefreshVisible, the event "Refreshing by pull/release" of the Table control is not run.
Remark: It is possible to force the execution of this event by using function ExecuteProcess with the constant trtPullToRefresh.
To hide the refresh banner, it is necessary to call <Table>.RefreshVisible(False) as many times as <Table>.RefreshVisible(True) has been executed.

Component: wd260java.dll