Xbasic

WaitDialog Class

Description

Creates a new modeless dialog box with a progress bar. The object is derived from the WaitDialog class and has the following functions.

Example

dim p3 as waitdialog
p3.create(3,"percent")
p3.Set_Bottom_Message(crlf()+"This is the bottom row message")
p3.Set_Message("this is the top row message")
p3.Set_Percent(50,60)
p3.set_percent(60,60)
dim p3 as waitdialog
p3.create(1,"repeating")
p3.set_message("this is the top row message")
p3.Set_Color("red")
dim p3 as waitdialog
p3.create(2,"repeating")
p3.set_bottom_message("hello. i am working...")
dim p3 as waitdialog
p3.create(3,"bounce")
p3.set_color("dark green")

Methods

WAITDIALOG.ALLOWCANCEL Method

The .ALLOWCANCEL() method enables or disables the Cancel button on a Wait Dialog. The Cancel button closes the Wait Dialog.

WAITDIALOG.CANCEL_CANCEL Method

The .CANCEL_CANCEL() method cancels the Cancel button request made by a user.

WAITDIALOG.CLOSE Method

The .CLOSE() method closes the {WAITDIALOG} dialog box referenced by .

WAITDIALOG.CREATE Method

The .CREATE() method creates and displays the {WAITDIALOG} dialog box with progress bar.

WAITDIALOG.HAS_CLOSE_BUTTON Method

The .HAS_CLOSE_BUTTON() method displays or hides the close button on a progress dialog.

WAITDIALOG.PAUSE Method

The .PAUSE() method halts the update of a progress bar created with the repeating style by <WAITDIALOG>.CREATE().

WAITDIALOG.REFRESH Method

The .REFRESH() method redisplays a progress dialog.

WAITDIALOG.RESUME Method

The .RESUME() method continues the update of a progress bar created with the repeating style by <WAITDIALOG>.CREATE().

WAITDIALOG.SET_BOTTOM_MESSAGE Method

The .SET_BOTTOM_MESSAGE() method sets the message to display below the progress bar. The message is only visible if Message_Rows (in <WAITDIALOG>.CREATE()) is greater than 1.

WAITDIALOG.SET_COLOR Method

The .SET_COLOR() method sets the color of a progress bar created with the bounce or repeating styles by <WAITDIALOG>.CREATE().

WAITDIALOG.SET_MESSAGE Method

The .SET_MESSAGE() method sets the message above the progress bar. The message is only visible if Message_Rows (in <WAITDIALOG>.CREATE()) is greater than 0.

WAITDIALOG.SET_PERCENT Method

The .SET_PERCENT() method sets the position of the progress bar when the progress bar has been created with style "percent".

WAITDIALOG.SET_TITLE Method

The .SET_TITLE() method displays text on the title bar of the progress dialog.

WAITDIALOG.USER_CANCELED Method

The .USER_CANCELED()returns .T. if the user presses the Cancel button on a Wait Dialog.