ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Mouse functions
  • Miscellaneous
  • Operating mode in Android
  • Operating mode in iPhone/iPad
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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.
AndroidiPhone/iPad Displays or hides an endless progress bar.
Example
HourGlass()         // Display the hourglass
ProcProcess()  // Long process
HourGlass(False)     // Restore the initial pointer
AndroidiPhone/iPad
// 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 constant
Activation or deactivation constant:
FalseCancels the hourglass that was enabled last. If this houglass is the only one that is enabled, the mouse cursor takes its initial shape.
falseAllHourglassCancels all current hourglasses to restore the initial shape of mouse cursor.
iPhone/iPad 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.
Android

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.
Remark: 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.
iPhone/iPad

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.
Remark: 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: wd290obj.dll
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: 06/08/2022

Send a report | Local help