PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Scope of DelayBeforeClosing
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
Limits the display duration of a window or dialog box.
If no user action is performed, when the specified amount of time is reached:
  • for a window, the code of a window button will be run.
  • for a dialog box, the dialog box is automatically closed. For the question or confirmation dialog boxes, the expected answer corresponds to the default button.
The amount of time specified for the automatic closing is ignored in the following cases:
  • when the user clicks a button.
  • if the user modifies a control.
  • if the user presses any keyboard key.
Note: The following dialog boxes are taken into account:
By default, the dialog boxes are locking: the application is locked as long as these windows are opened.
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.
Example
// Close the dialog box in 2 seconds
DelayBeforeClosing(200)
Error("The application will be ended")
EndProgram()
// Run the code of BTN_CloseButton in 5 seconds
DelayBeforeClosing(MyWindow, BTN_Close, 500)
// The code of BTN_Close button calls the Close function
Syntax

Time-out before closing the dialog boxes Hide the details

<Result> = DelayBeforeClosing([<Time-out>])
<Result>: Integer
Time-out that was previously defined (before the modification performed by DelayBeforeClosing).
<Time-out>: Optional integer or optional Duration
New time-out before closing the dialog boxes of application (expressed in hundredths of a second). This parameter can correspond to:
  • an integer corresponding to the number of hundredths of a second,
  • a Duration variable,
  • Versions 23 and later
    the direct indication of duration (1 s or 10 ms for example).
    New in version 23
    the direct indication of duration (1 s or 10 ms for example).
    the direct indication of duration (1 s or 10 ms for example).
If this parameter is set to 0 or if it is not specified, the time-out is endless (default case): the dialog boxes are not automatically closed.

Time-out before closing the windows Hide the details

<Result> = DelayBeforeClosing(<Window Name> , <Button Name> [, <Time-out>])
<Result>: Integer
Time-out that was previously defined (before the modification performed by DelayBeforeClosing).
<Window Name>: Character string (with or without quotes)
Name of window for which an automatic process will be managed.
<Button Name>: Character string (with or without quotes)
Name of button whose code will be run after the specified time-out. If the window must be closed, the button code must contain Close.
<Time-out>: Optional integer or optional Duration
Amount of time before running the click code of specified button (expressed in hundredths of a second).
This parameter can correspond to:
  • an integer corresponding to the number of hundredths of a second,
  • a Duration variable,
  • Versions 23 and later
    the direct indication of duration (1 s or 10 ms for example).
    New in version 23
    the direct indication of duration (1 s or 10 ms for example).
    the direct indication of duration (1 s or 10 ms for example).
If this parameter is set to 0 or if it is not specified, the time-out is endless (default case): the specified window will not be automatically closed and the time-out that was previously defined is canceled.
Remarks

Scope of DelayBeforeClosing

  • Dialog boxes: DelayBeforeClosing is taken into account for all the dialog boxes opened by the application, regardless of the code where this function is called.
    To restore a standard operating mode, use DelayBeforeClosing and specify no time-out.
  • Window: DelayBeforeClosing only applies to the specified window. The function is disabled when this window is closed: if this window is re-opened (Open), the window will not be automatically closed. DelayBeforeClosing must be re-used.
Components
WINDEVReports and Queries wd230obj.dll
Windows Mobile wp230obj.dll
Java wd230java.jar
Linux wd230obj.so
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment