.wait()

Previous Next

Displays a Wait Control affecting the user's entire screen. This prevents the user from performing any additional actions while an operation is running.

Several other calls, for example: $.udb.commit(), $.udb.checkData() and $.udb.executeSQLStatement, have a waitState option. This is another way to display a Wait Control. In this case, the Wait Control is displayed when the function starts, and is hidden again when the function finishes.

Returns a Promise object.

Syntax

.wait( activatewait-message )

 

.wait( wait-functionwait-message )

 

.wait( wait-functionoptions )

 

activate :=  { true | false }

 

options  := {

 message: wait-message,

 timeout: wait-timeout,

 src: wait-image,

 alt: wait-image-description

}

 

wait-timeout := integer

Activate is a mandatory boolean that is used to turn the Wait Control on or off.

If activate is true, the Wait Control is displayed (with a wait-message, if specified).

If activate is false, the Wait Control is removed.

Wait-function is a function that is called while the Wait Control is displayed. The Wait Control is displayed (with a wait-message, if specified) before the function executes. The Wait Control is removed automatically when the function finishes.

Options is a struct that can have the following items, all of which are optional.

Wait-message is a message that is displayed for the time that the Wait Control is displayed. This message is also handled by the translation engine. The default is ‘Loading…’ .

Wait-timeout is an integer that indicates a time-out period in milliseconds that expires before wait-function executes. The time-out period starts when the Wait Control is displayed. Wait-function executes when the time-out period expires. The Wait Control is removed when the function finishes. The default for wait-timeout is 0, meaning that by default, no time-out period applies.

Wait-image is the URI of the image displayed while the Wait Control is displayed. By default this is a ‘Loading’ icon.

Wait-image-description is a description provided for the wait image. The default is ‘Loading...’ .

 

Examples

$.udb.wait( true );

 

$.udb.wait( function() {

    //...

}, {

     message: ""Processing results",

     timeout: 2000

});