ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Window functions
  • "Request for refreshing the display" event
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Warning
From version 25, this function is kept for backward compatibility. It is recommended to use RequestRefreshUIParent.
When called from the "Request for refreshing the display" event of a supercontrol, control template, internal window or internal page, the function asks for the execution of the event "Request for refreshing the display of the higher level. (This usually means the window, but it can also be a supercontrol a control template or an internal window). This event will be run at the end of the current process.
If this function is called several times in the same process, the event "Request for refreshing the display" will only be run once at the end of the current process.
Remark: This function is mainly used:
Example
// Process records
// The graphic interface will have to be refreshed
RequestRefreshUIParent()
// -----------------------------------------------------------------
// -- 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
RequestUpdateUIParent([<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" event of the window or page.
<Parameter N>: Type of value expected by the "Request for refreshing the display" event
Nth parameter that will be passed to the "Request for refreshing the display" event of the window or page.
Remarks

"Request for refreshing the display" event

One of the events associated with the window or page is "Request for refreshing the display". This event makes it possible to group the code for refreshing the controls of a window or page: 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 run upon request by the following functions:
  • RequestUpdateUI: Runs the event "Request for refreshing the display" at the end of the current process (asynchronous execution).
  • ExecuteUpdateUI: Immediately executes the "Request for refreshing the display" event.
  • RequestRefreshUIParent: Executes the "Request for refreshing the display" event of the higher level at the end of the current process (asynchronous execution).
  • ExecuteUpdateUIParent: Immediately executes the "Request for refreshing the display" event of the higher level.
When these functions are called, you can specify the value of the parameters expected by the event.
Business / UI classification: Neutral code
Component: wd290vm.dll
Minimum version required
  • Version 22
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help