PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version: 19.0
Your version: XXA150056M

  • Various
  • Operating mode in Android
  • Operating mode in Windows Phone
  • Operating mode in iPhone/iPad
WinDevWebDev - Server codeWebDev - Browser codeWinDev MobileReports and QueriesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidAndroid Widget iPhone/iPadJavaPHPAjaxUser code (UMC)External languageHFSQLHFSQL Client/ServerStored proceduresHyper File 5.5OLE DBODBCNative Accesses

HourGlass (Function)
In French: Sablier

Transforms the mouse cursor into an 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 display of the hourglass may not be immediate (about 1 second delay).

AndroidiPhone/iPad Displays or hides an endless progress bar.

Versions 15 and later
WinDev MobileAndroid This function is now available for the Android applications.
New in version 15
WinDev MobileAndroid This function is now available for the Android applications.
WinDev MobileAndroid This function is now available for the Android applications.

Versions 16 and later
WinDev MobileWindows Phone This function is now available for the Windows Phone applications.
New in version 16
WinDev MobileWindows Phone This function is now available for the Windows Phone applications.
WinDev MobileWindows Phone This function is now available for the Windows Phone applications.
Versions 17 and later
WinDev MobileiPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
WinDev MobileiPhone/iPad This function is now available for the iPhone/iPad applications.
WinDev MobileiPhone/iPad This function is now available for the iPhone/iPad applications.

Versions 18 and later
WinDev MobileWindows Store apps This function is now available in Windows Store apps mode.
New in version 18
WinDev MobileWindows Store apps This function is now available in Windows Store apps mode.
WinDev MobileWindows Store apps This function is now available in Windows Store apps 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([<Enabled>])
<Enabled>: Optional boolean
  • True (default value) to enable the hourglass,
  • False to restore the initial shape of the mouse cursor.
Windows PhoneAndroid The <Enabled> parameter is mandatory.

Remarks

Various

  • To restore the cursor to its initial status, HourGlass(False) must be called as many times as HourGlass(True) was run.
  • When a WLanguage process ends, the cursor is automatically restored to its standard shape.
  • Windows PhoneAndroid 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

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 the <Enabled> parameter set to False as many times as HourGlass was used with the <Enabled> parameter set to 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

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 the <Enabled> parameter set to False as many times as HourGlass was used with the <Enabled> parameter set to 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

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 the <Enabled> parameter set to False as many times as HourGlass was used with the <Enabled> parameter set to 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
Windows Phone

Operating mode in Windows Phone

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 the <Enabled> parameter set to False as many times as HourGlass was used with the <Enabled> parameter set to True.

New in version 16
Windows Phone

Operating mode in Windows Phone

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 the <Enabled> parameter set to False as many times as HourGlass was used with the <Enabled> parameter set to True.

Windows Phone

Operating mode in Windows Phone

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 the <Enabled> parameter set to False as many times as HourGlass was used with the <Enabled> parameter set to True.

Versions 17 and later
iPhone/iPad

Operating mode in iPhone/iPad

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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

The use of HourGlass triggers the display of an infinite progress bar. The interface of the application 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 wp190obj.dll
Android wd190android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment