WaitWindowStart (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Window functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

WaitWindowStart (Function)

In french: FenAttenteDébut

Opens the loading window of application. The user cannot access the graphic application interface as long as the loading window of application is displayed.

Example

// Downloads an image from Internet and displays it in an Image control of application

// Display the loading window
WaitWindowStart("Downloading the image...")

// Start the download thread
ThreadExecute("MyThread", threadNormal, procDownloadImage)

	INTERNAL PROCEDURE procDownloadImage
		// Download the image
		IF HTTPRequest("https://www.windev.com/img/visual/21/logo-pcsoft.png") THEN
			bufImage is Buffer = HTTPGetResult()
			// Display the downloaded image in an Image control of the window
			ExecuteMainThread(procUpdImage)
				INTERNAL PROCEDURE procUpdImage
					IMG_NoName1 = bufImage
				END
			// Close the loading window
			WaitWindowEnd()
		END
	END

Syntax

WaitWindowStart(<Message>)

<Message>: Character string

Message to display in the loading window.

Remarks

To close the loading window, WaitWindowEnd must be called as many times as WaitWindowStart was called.
A single loading window can be displayed at a time. If WaitWindowStart is called while the loading window is already opened, the message displayed will be refreshed with the message specified during the last call.
WaitWindowStart and WaitWindowEnd can be called from a secondary thread.
The loading window displays an infinite progress bar. In order for this progress bar to be displayed and animated, you must give control back to the main application thread when running the process that requires a wait. This process should be performed in a secondary thread or in a parallel task. If the process must access the GUI, call ExecuteMainThread to perform these accesses.
The loading window opened by WaitWindowStart uses the same window as the one displayed for the application hourglass (Hourglass). The calls to Hourglass and WaitWindowStart/WaitWindowEnd should not be nested.
The loading window is linked to the current window when it was opened. If this window is closed, the loading window will also be closed.

Business / UI classification: UI Code

Component: wd300android.jar