PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Your version: XXA150056M

  • Various
  • Operating mode in Android
  • Operating mode in Windows Phone
  • Operating mode in iPhone/iPad
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Windows Mobile The hourglass may not be immediately displayed (about 1 second delay).
AndroidiPhone/iPad Displays or hides an endless progress bar.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 16 and later
Universal Windows 10 App This function is now available for the Windows Phone applications.
New in version 16
Universal Windows 10 App This function is now available for the Windows Phone applications.
Universal Windows 10 App This function is now available for the Windows Phone applications.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App 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
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 boolean
  • True (default value) to enable the hourglass,
  • False to restore the initial shape of mouse cursor.
Android The <Activation> parameter is mandatory.
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.
Versions 22 and later
falseAllHourglass
New in version 22
falseAllHourglass
falseAllHourglass
Cancels all current hourglasses to restore the initial shape of mouse cursor.
iPhone/iPad Deletes the infinite progress bar.
Android This constant is not available.
True
(Default value)
Enables the hourglass.
Android 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.
  • Android 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
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 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
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 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.
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 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
Universal Windows 10 App

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
Universal Windows 10 App

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.
Universal Windows 10 App

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
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.
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
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.
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.
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.
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.
Components
Windows Mobile wp230obj.dll
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment