HourGlass (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Various
Operating mode in Android
Operating mode in Windows Phone
Operating mode in iPhone/iPad

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HourGlass (Function)

In french: Sablier

Transforms the mouse cursor into hourglass (and conversely). This allows you to inform the user that a long process is performed by displaying an hourglass. The window is inactive as long as the hourglass is displayed: the user cannot click in the window.

The hourglass may not be immediately displayed (about 1 second delay).

Displays or hides an endless progress bar.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for Windows Phone applications.

New in version 16

This function is now available for Windows Phone applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

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

HourGlass() // Display the hourglass
ProcProcess() // Long process
HourGlass(False) // Restore the initial pointer

// Display the message in the progress bar
NextTitle("Connection...")
HourGlass()

// Long process
ProcProcess()

// In Android and IOS, update the progress bar during the process.
Multitask(-1)

// Stop the infinite progress bar
HourGlass(False)
NextTitle("")

Syntax

HourGlass([<Activation>])

<Activation>: Optional boolean

True (default value) to enable the hourglass,
False to restore the initial shape of mouse cursor.
The <Activation> parameter is mandatory.

HourGlass([<Activation>])

<Activation>: Optional constant

Activation or deactivation constant:
False Cancels the hourglass that was enabled last. If this houglass is the only one that is enabled, the mouse cursor takes its initial shape.
Versions 22 and later
falseAllHourglass
New in version 22
falseAllHourglass
falseAllHourglass Cancels all current hourglasses to restore the initial shape of mouse cursor.
Deletes the infinite progress bar.
This constant is not available.
True
(Default value) Enables the hourglass.
The <Activation> parameter is mandatory.

Remarks

Various

To restore the cursor to its initial status:
- call HourGlass(False) as many times as HourGlass(True) was run.
- Versions 22 and later
  use the falseAllHourglass constant.
  New in version 22
  use the falseAllHourglass constant.
  use the falseAllHourglass constant.
When a WLanguage process ends, the cursor is automatically restored to its standard shape.

When a WLanguage process ends, you must use HourGlass(False) in order for the cursor to be restored to its standard shape.

Versions 15 and later

Operating mode in Android

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

The following actions can be performed:

To display a message, use NextTitle.
To modify the message while the progress bar is displayed, all you have to do is re-run NextTitle then HourGlass.
To hide the progress bar, use HourGlass with <Activation> = False as many times as HourGlass was called with <Activation> = True.

Note: When running long processes, we advise you to add calls to Multitask in the code in order to give time to the progress bar to refresh its display.

New in version 15

Operating mode in Android

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

The following actions can be performed:

To display a message, use NextTitle.
To modify the message while the progress bar is displayed, all you have to do is re-run NextTitle then HourGlass.
To hide the progress bar, use HourGlass with <Activation> = False as many times as HourGlass was called with <Activation> = True.

Note: When running long processes, we advise you to add calls to Multitask in the code in order to give time to the progress bar to refresh its display.

Operating mode in Android

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

The following actions can be performed:

To display a message, use NextTitle.
To modify the message while the progress bar is displayed, all you have to do is re-run NextTitle then HourGlass.
To hide the progress bar, use HourGlass with <Activation> = False as many times as HourGlass was called with <Activation> = True.

Note: When running long processes, we advise you to add calls to Multitask in the code in order to give time to the progress bar to refresh its display.

Versions 16 and later

Operating mode in Windows Phone

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

To hide the progress bar, use HourGlass with <Activation> = False as many times as HourGlass was called with <Activation> = True.

New in version 16

Operating mode in Windows Phone

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

To hide the progress bar, use HourGlass with <Activation> = False as many times as HourGlass was called with <Activation> = True.

Operating mode in Windows Phone

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

To hide the progress bar, use HourGlass with <Activation> = False as many times as HourGlass was called with <Activation> = True.

Versions 17 and later

Operating mode in iPhone/iPad

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

To display a message, use NextTitle.

Note: When running long processes, we advise you to add calls to Multitask in the code in order to give time to the progress bar to refresh its display.

New in version 17

Operating mode in iPhone/iPad

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

To display a message, use NextTitle.

Note: When running long processes, we advise you to add calls to Multitask in the code in order to give time to the progress bar to refresh its display.

Operating mode in iPhone/iPad

Using HourGlass triggers the display of an infinite progress bar. The application interface can no longer be handled by the user as long as the hourglass is displayed.

By default, no message is displayed beside the progress bar.

To display a message, use NextTitle.

Note: When running long processes, we advise you to add calls to Multitask in the code in order to give time to the progress bar to refresh its display.

Component : wd250obj.dll