HourGlass (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Mouse functions

Miscellaneous
Operating mode in Android
Operating mode in iPhone/iPad

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HourGlass (Function)

In french: Sablier

Transforms the mouse cursor into hourglass and vice versa. This allows you to inform the user that a long process is performed by displaying an hourglass. For the duration of the HourGlass display, the window is inactive: the user cannot click in the window.

Displays or hides an endless progress bar.

Example

HourGlass()         // Affichage du sablier
ProcTraitement()  // Traitement long
HourGlass(False)     // Restitution du pointeur initial

// Affichage du message dans la jauge
NextTitle("Connexion ...") 
HourGlass() 

// Traitement long
ProcTraitement()  

// Sous Android et IOS, mise à jour de la jauge pendant le traitement.
Multitask(-1)    

// Arrêt de la jauge infinie
HourGlass(False)     
NextTitle("")

Syntax

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.
falseAllHourglass Cancels all current hourglasses to restore the initial shape of mouse cursor.
Deletes the infinite progress bar.
True
(Default value) Enables the hourglass.

Remarks

Miscellaneous

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

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 change the message while the progress bar is displayed, simply run NextTitle again, and then run 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 recommend adding calls to function Multitask in the code, to give the ProgressBar time 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 recommend adding calls to function Multitask in the code, to give the ProgressBar time to refresh its display.

Component: wd300obj.dll

See also

Minimum version required

Version 9

This page is also available for…

Comments

Video HourGlass

https://youtu.be/tpuThghZguE
https://windevdesenvolvimento.blogspot.com/2019/09/dicas-2282-windev-webdev-mobile.html
// BTN_DIRETORIO_LISTA
HourGlass(True)
s_arquivos_todos is string=fListDirectory(EDT_DIRETORIO)
s_arquivo_individual is string=""
TVT_DIRETORIO.DeleteAll()
FOR EACH STRING s_arquivo_individual OF s_arquivos_todos SEPARATED BY CR
nPOSICAO is int=TVT_DIRETORIO.AddLine()
TVT_DIRETORIO.COL_01_DIRETORIO[nPOSICAO]=s_arquivo_individual
END
HourGlass()

amarildo

10 Sep. 2019

Video HourGlass

https://youtu.be/gKsEf55d_-w

https://windevdesenvolvimento.blogspot.com/2019/06/dicas-2156-windev-webdev-mobile.html

// btn_lupa_ampuleta_aguarde_hourglass
HourGlass()
// PROCESSO
FOR nContador = 1 TO 40000
trace(nContador)
END
//FINAL PROCESSO
HourGlass ( False )

amarildo

14 Jun. 2019

Video HourGlass

https://youtu.be/nlNN6dTlIgA

https://windevdesenvolvimento.blogspot.com/2019/03/dicas-2041-windev-comandos-45-hourglass.html

// BTN_AMPULETA_HOURGLASS
HourGlass ()
FOR nContador = 1 TO 40000
Message(nContador)
END
HourGlass ( False )

amarildo

11 Mar. 2019

Last update: 03/27/2025

Send a report | Local help