<Looper>.AddInProgress (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Looper functions

Prefix syntax

AddInProgress

Presentation

Example

See also

<Looper>.AddInProgress (Function)

In french: <Zone répétée>.AjoutEnCours

Modifies or returns the visibility status of internal wait window when adding additional elements into an infinite Looper control.

Example

// Event "Adding additional elements"
LOOP_MyLooper.AddInProgress(True)
ThreadExecute(myProcGetAdditionalResult)

// -----
PROCEDURE myProcGetAdditionalResult()

QRY_MoreData.MinID = LOOP_MyLooper[LOOP_MyLooper.Count].ID
QRY_MoreData.ExecuteQuery() // Execute a long query
REQ_MoreData.ReadFirst()
WHILE NOT HOut(QRY_MoreData)
// Add elements to the Looper control from the main thread
// to modify the UI
// AddIntoMainThead will use the WLanguage ExecuteMainThread function
AddIntoMainThead(LOOP_MyLooper, QRY_MoreData.Title, ...
QRY_MoreData.Photo, QRY_MoreData.ArticleID)
REQ_MoreData.ReadNext()
END

LOOP_MyLooper.AddInProgress(False)

Syntax

Modifying the visibility status of internal wait window Hide the details

<Looper control>.AddInProgress(<Visible>)

<Looper control>: Control name

Name of the Looper control to be used.

<Visible>: Boolean

True to display the internal wait window,
False to hide it.

Retrieving the visibility status of internal wait window Hide the details

<Result> = <Looper control>.AddInProgress()

<Result>: Boolean

True if the internal wait window is displayed,
False otherwise.

<Looper control>: Control name

Name of the Looper control to be used.

Remarks

When using an infinite Looper control, an internal wait window (containing a Progress Bar control) is displayed above the rows of the Looper control while additional data is being added. This wait window is hidden at the end of the event "Adding additional elements".
<Looper>.AddInProgress is used for example to check the display of wait window when the data found in the Looper control is refreshed in a secondary thread. This prevents the application from freezing (the example uses this method).
When <Looper>.AddInProgress makes the wait window visible, the event "Adding additional elements" of the Looper control is not run.
To hide the refresh bar, <Looper>.AddInProgress(False) must be called as many times as <Looper>.AddInProgress(True) was run.

Component: wd280obj.dll