PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Title of dialog boxes
  • Presentation of title
  • Minimized window
  • Special case in Android and iOS: Using the Hourglass function
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
Modifies the title of next window to open.
Reminder: By default, the window title is the one defined in the editor.
WEBDEV - Server code Modifies the title of next dialog box opened.
Versions 21 and later
Android Note: Run in the initialization code of project, NextTitle is used to update the caption displayed on the splash screen.
New in version 21
Android Note: Run in the initialization code of project, NextTitle is used to update the caption displayed on the splash screen.
Android Note: Run in the initialization code of project, NextTitle is used to update the caption displayed on the splash screen.
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
WINDEVLinux This function is now available for the WINDEV applications in Linux.
New in version 16
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
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
Android Widget This function is now available in Android Widget mode.
New in version 18
Android Widget This function is now available in Android Widget mode.
Android Widget This function is now available in Android Widget 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
WINDEVReports and QueriesAndroidAndroid Widget iPhone/iPadWindows MobileJavaAjaxUser code (UMC)
// Modify the title of next window to open
NextTitle("Modifying a customer form")
Syntax
NextTitle(<New Title>)
<New Title>: Character string (with quotes)
New title of next window or dialog box to open.
WEBDEV - Server code New title of next dialog box to open.
Remarks

Title of dialog boxes

By default, the windows opened by Warning, Confirm, Dialog, Error, ErrorInfo, Info, OKCancel or YesNo have the same title as the previous window. NextTitle is used to modify this title.
WEBDEV - Server code NextTitle is used to modify the title of the dialog boxes opened by Confirm, OKCancel or YesNo. The title of the dialog boxes displayed by Error and Info cannot be modified.
WINDEVReports and QueriesWindows MobileUser code (UMC)

Presentation of title

The drawing functions in the list boxes (starting with the letter "g") are used to:
  • add drawings to the title,
  • modify the formatting of title (background color, text color, etc.) with gBackground and gPen.
For example: to modify the text color and the background color of title:
NextTitle(EOT + gBackground(RGB(0, 255, 255)) + gPen(RGB(255, 0, 0)) + "Color test")
Special case in Windows Vista and later: The windows that is using the "Aero system" style cannot have a graphic title: the graphic part is ignored. If "Aero" is not enabled, the graphic title will be displayed as usual.
WINDEVReports and QueriesJavaUser code (UMC)

Minimized window

When a window is minimized, the title of this window is displayed beside the icon in the taskbar.
Versions 15 and later
AndroidiPhone/iPad

Special case in Android and iOS: Using the Hourglass function

The use of 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 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 Example:
// This example explains how to copy several HFSQL files
// from a HFSQL server to a local directory.
// In this example, an information is displayed for each copy.
// sConnection is a connection defined by programming.

gsMyLocalHFPath is string = SysDirStorageCard() + fSep() + "MyApplication Data" + fSep()
sPassword is string = "My password"

NextTitle("Copying the Category file")
HourGlass(True)
IF not HCopyFile("", ...
gsMyLocalHFPath + Category..Name + ".fic", sConnection, Category..Name + ".fic", ...
hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the BankAccount file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + BankAccount..Name + ".fic", ...
sConnection, BankAccount..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the Operations file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + Operations..Name + ".fic", ...
sConnection, Operations..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the SubCategory file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + SubCategory..Name + ".fic", ...
sConnection, SubCategory..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the User file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + User..Name + ".fic", ...
sConnection, User..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END
// Close the houglasses
HourGlass(False)
HourGlass(False)
HourGlass(False)
HourGlass(False)
HourGlass(False)

Info("The files have been copied onto the Smartphone.")
New in version 15
AndroidiPhone/iPad

Special case in Android and iOS: Using the Hourglass function

The use of 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 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 Example:
// This example explains how to copy several HFSQL files
// from a HFSQL server to a local directory.
// In this example, an information is displayed for each copy.
// sConnection is a connection defined by programming.

gsMyLocalHFPath is string = SysDirStorageCard() + fSep() + "MyApplication Data" + fSep()
sPassword is string = "My password"

NextTitle("Copying the Category file")
HourGlass(True)
IF not HCopyFile("", ...
gsMyLocalHFPath + Category..Name + ".fic", sConnection, Category..Name + ".fic", ...
hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the BankAccount file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + BankAccount..Name + ".fic", ...
sConnection, BankAccount..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the Operations file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + Operations..Name + ".fic", ...
sConnection, Operations..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the SubCategory file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + SubCategory..Name + ".fic", ...
sConnection, SubCategory..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the User file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + User..Name + ".fic", ...
sConnection, User..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END
// Close the houglasses
HourGlass(False)
HourGlass(False)
HourGlass(False)
HourGlass(False)
HourGlass(False)

Info("The files have been copied onto the Smartphone.")
AndroidiPhone/iPad

Special case in Android and iOS: Using the Hourglass function

The use of 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 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 Example:
// This example explains how to copy several HFSQL files
// from a HFSQL server to a local directory.
// In this example, an information is displayed for each copy.
// sConnection is a connection defined by programming.

gsMyLocalHFPath is string = SysDirStorageCard() + fSep() + "MyApplication Data" + fSep()
sPassword is string = "My password"

NextTitle("Copying the Category file")
HourGlass(True)
IF not HCopyFile("", ...
gsMyLocalHFPath + Category..Name + ".fic", sConnection, Category..Name + ".fic", ...
hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the BankAccount file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + BankAccount..Name + ".fic", ...
sConnection, BankAccount..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the Operations file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + Operations..Name + ".fic", ...
sConnection, Operations..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the SubCategory file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + SubCategory..Name + ".fic", ...
sConnection, SubCategory..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END

NextTitle("Copying the User file")
HourGlass(True)
IF not HCopyFile("", gsMyLocalHFPath + User..Name + ".fic", ...
sConnection, User..Name + ".fic", hCopyIndex, "", sPassword) THEN
Error("Error while copying the file " + Category..Name + " locally")
END
// Close the houglasses
HourGlass(False)
HourGlass(False)
HourGlass(False)
HourGlass(False)
HourGlass(False)

Info("The files have been copied onto the Smartphone.")
Components
WINDEVReports and Queries wd230obj.dll
WEBDEV - Server code wd230page.dll
Windows Mobile wp230obj.dll
Java wd230java.jar
Linux wd230obj.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment