PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Characteristics of dialog box
  • Various
  • Emulation
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
Displays a custom error message in a system error window.
To close the window, the user must click the OK button to validate.
WINDEV WINDEV allows you to apply the skin template of your project to this dialog box. See Customizing the dialog boxes for more details.
Versions 16 and later
WINDEVWEBDEV - Server code In a Webservice, ErrorBuild is used to define the error returned by the Webservice. If several call to ErrorBuild are performed, the error messages are concatenated.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
New in version 16
WINDEVWEBDEV - Server code In a Webservice, ErrorBuild is used to define the error returned by the Webservice. If several call to ErrorBuild are performed, the error messages are concatenated.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WINDEVWEBDEV - Server code In a Webservice, ErrorBuild is used to define the error returned by the Webservice. If several call to ErrorBuild are performed, the error messages are concatenated.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Versions 17 and later
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
New in version 17
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
WEBDEV - Browser code This function is now available in Browser code.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
WEBDEV - Browser code This function is now available in Browser code.
Universal Windows 10 App This function is now available in Windows Store apps mode.
WEBDEV - Browser code This function is now available in Browser code.
Versions 19 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 19
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 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 QueriesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaUser code (UMC)
NextTitle("Error: Unknown customer")
ErrorBuild("The %1 code does not exist. It must be created beforehand.", ...
nClientCode)
Syntax
ErrorBuild(<Format String> [, <Parameter 1> ... [, <Parameter N>]])
<Format String>: Character string
Character string to display containing optional parameters (%1 to %n). To display the % character, this character must be typed twice (%%).
<Parameter 1>: Optional character string (with quotes)
First parameter that will be inserted into the formatted character string.
<Parameter 1> will replace the %1 character, <Parameter 2> will replace the %2 character, etc.
The number of specified parameters must be equal to or greater than the number of parameters used in <Format String>.
If <Format String> contains more parameters, the additional parameters will be replaced by empty strings.
<Parameter N>: Optional character string (with quotes)
Nth parameter that will be inserted into the formatted character string.
<Parameter 1> will replace the %1 character, <Parameter 2> will replace the %2 character, etc.
The number of specified parameters must be equal to or greater than the number of parameters used in <Format String>.
If <Format String> contains more parameters, the additional parameters will be replaced by empty strings.
Remarks

Characteristics of dialog box

  • The title of dialog box corresponds to the title of current window.
    iPhone/iPad To comply with the system specifications, the title of dialog box is empty by default. To define this title, use NextTitle. AndroidiPhone/iPad To comply with the system specifications, the title of dialog box is empty by default. To define this title, use NextTitle.
  • To modify or define the title of dialog box, use NextTitle.
  • The message is aligned to left.
  • The button caption depends on the runtime language of Windows.
  • The maximum number of characters cannot exceed 4096. If a larger string is passed in parameter, it will be truncated.
  • The icon displayed (white cross) cannot be modified.
WINDEV To customize this dialog box (as well as all the system dialog boxes of your application), check "Apply the template theme to the system information windows" in the Style tab of the project description. See Customizing the dialog boxes for more details.
WEBDEV - Server code
Versions 16 and later
To customize this dialog box (as well as all the system dialog boxes of your site), check "Apply the skin to the dialog boxes (Info, YesNon, Confirm, ...)" in the style tab of project description.
New in version 16
To customize this dialog box (as well as all the system dialog boxes of your site), check "Apply the skin to the dialog boxes (Info, YesNon, Confirm, ...)" in the style tab of project description.
To customize this dialog box (as well as all the system dialog boxes of your site), check "Apply the skin to the dialog boxes (Info, YesNon, Confirm, ...)" in the style tab of project description.

Various

  • The timers (TimerSys) and the events are not stopped when this function is called.
  • WINDEV When typing the function in the code editor, you have the ability to use the code wizard. Depending on the characteristics entered in the wizard, the function used can be different in the code that is automatically generated.
  • WINDEVWindows MobileJava DelayBeforeClosing is used to limit the display duration of the message. The dialog box is automatically closed. For the question or confirmation dialog boxes, the expected answer corresponds to the default button.
  • The caption of the button is displayed in the language used by Windows on the current computer.
  • iPhone/iPad This function must not be used:
    • in the process for resizing windows. Otherwise, the application will be locked.
    • in the process for changing the orientation of windows.
    • in the "Move to the foreground" process associated with the project.
      Note: However, the function can be used in the "Move to the foreground" process of a window.
    • in a thread.
WINDEV

Emulation

An error message can be emulated by EmulateError.
Components
WINDEVReports and Queries wd230obj.dll
WEBDEV - Server code wd230page.dll
Windows Mobile wp230obj.dll
WEBDEV - Browser code WDJS.DLL
Java wd230java.jar
Linux wd230obj.so
Android wd230android.jar
Minimum required version
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment