PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • "Request for refreshing the display" event
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
Warning
From version 24, RequestUpdateUI is kept for backward compatibility. This function is replaced by RequestRefreshUI.
Requests the execution of the event "Request display update" (and returns the hand without waiting for the execution of the event).
Remarks:
  • The event "Display Update Request" is available on windows, internal windows, pages, internal pages, field templates and superfields.
  • If this function is called several times, calls with the same parameters not yet executed are ignored.
  • In the case of a call in main the thread, the execution(s) of the "Display Update Request" event will be performed at the end of the current processing.
  • In the case of a call in a secondary thread, the execution(s) of the "Display Update Request" event will be performed when the window is refreshed.
Uses: This function is mainly used:
  • when refreshing the interface via threads.
Versions 24 and later
Windows This function is now available for WEBDEV sites in Windows.
New in version 24
Windows This function is now available for WEBDEV sites in Windows.
Windows This function is now available for WEBDEV sites in Windows.
Example
// Process records
// The graphic interface will have to be refreshed
RequestRefreshUI()
// -----------------------------------------------------------------
// -- Request for refreshing the display of WIN_Contact_Form
// Refresh the title of the window
MySelf..Title = gpclContactForm.p_sFullname
 
// Refresh the linked controls of the window
SourceToScreen()
Syntax
RequestRefreshUI([<Parameter 1> [... [, <Parameter N>]]])
<Parameter 1>: Optional parameter corresponding to the type expected by the event "Request for refreshing the display"
First parameter that will be passed to the "Request for refreshing the display" window event.
<Parameter N>: Type of value expected by the event "Request for refreshing the display"
Nth parameter that will be passed to the "Request for refreshing the display" window event.
Remarks

"Request for refreshing the display" event

One of the events associated with the window is "Request for refreshing the display". This event is used to group the code for refreshing the window controls: content of controls, state (visible, grayed, etc.), caption to refresh, etc.
This event can receive parameters. Simply declare a procedure in the event. For example:
// Request for refreshing the display
PROCÉDURE AskForRefresh(RefreshType is boolean)
This event is started upon request by the following functions:
  • RequestRefreshUI: Runs the event "Request for refreshing the display" at the end of the current process (asynchronous execution).
  • ExecuteRefreshUI: Immediately runs the event "Request for refreshing the display".
  • Versions 22 and later
    RequestRefreshUIParent: Runs the event "Request for refreshing the display" of the higher level at the end of the current process (asynchronous execution).
    New in version 22
    RequestRefreshUIParent: Runs the event "Request for refreshing the display" of the higher level at the end of the current process (asynchronous execution).
    RequestRefreshUIParent: Runs the event "Request for refreshing the display" of the higher level at the end of the current process (asynchronous execution).
  • Versions 22 and later
    ExecuteRefreshUIParent: Immediately runs the event "Request for refreshing the display" of the higher level. When these functions are called, you can specify the value of the parameters expected by "Request for refreshing the display".
    Remark: The element whose event "Request for display update" is executed depends on the code from which the functionRequestRefreshUI was called up.. If it is a class having the presenterattribute, the element considered will be the window associated with the class, otherwise it will be the element from which the code was launched.
    New in version 22
    ExecuteRefreshUIParent: Immediately runs the event "Request for refreshing the display" of the higher level. When these functions are called, you can specify the value of the parameters expected by "Request for refreshing the display".
    Remark: The element whose event "Request for display update" is executed depends on the code from which the functionRequestRefreshUI was called up.. If it is a class having the presenterattribute, the element considered will be the window associated with the class, otherwise it will be the element from which the code was launched.
    ExecuteRefreshUIParent: Immediately runs the event "Request for refreshing the display" of the higher level. When these functions are called, you can specify the value of the parameters expected by "Request for refreshing the display".
    Remark: The element whose event "Request for display update" is executed depends on the code from which the functionRequestRefreshUI was called up.. If it is a class having the presenterattribute, the element considered will be the window associated with the class, otherwise it will be the element from which the code was launched.
Business / UI classification: Neutral code
Component: wd260vm.dll
Minimum version required
  • Version 20
This page is also available for…
Comments
Click [Add] to post a comment