ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Window functions
  • "Request for refreshing the display" event
  • "Presenter" attribute
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
Requests the execution of the "Request for refreshing the display" event (and gives back control without waiting for the execution of the event).
This function is mainly used:
Remark: This function is equivalent to RequestUpdateUI.
Example
// Save process
// 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 "Request for refreshing the display" event
First parameter that will be passed to the "Request for refreshing the display" window event.
<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" 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: contents of controls, state (visible, grayed out...), text to refresh, etc, ... This event is available on windows, internal windows, pages, internal pages, control templates and supercontrols.
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: Executes the "Request for refreshing the display" event of the current element at the end of the current process (asynchronous execution).
  • ExecuteRefreshUI: Immediately executes the "Request for refreshing the display" event of the current element.
  • RequestRefreshUIElement: Executes the "Request for refreshing the display" event of the given element at the end of the current process (asynchronous execution).
  • ExecuteRefreshUIElement: Immediately executes the "Request for refreshing the display" event of the given element.
  • RequestRefreshUIParent: Executes the "Request for refreshing the display" event of the higher level at the end of the current process (asynchronous execution).
  • ExecuteRefreshUIParent: 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 "Request for refreshing the display".
Remarks:
  • The code that calls RequestRefreshUI determines the element whose event "Request for display update" is executed. If it is a class with the presenter attribute, the element will be the window associated with the class. Otherwise, it will be the element from which the code was executed.
  • If RequestRefreshUI is called multiple times, all subsequent calls with the same parameters as calls that have not yet been executed are ignored.
  • If RequestRefreshUI is called in main the thread, the "Request for refreshing the display" event will be executed after the current process.
  • If RequestRefreshUI is called in a secondary thread, the "Request for refreshing the display" event will be executed when the window is refreshed.
WINDEVWEBDEV - Server codeUniversal Windows 10 AppAndroidiPhone/iPad

"Presenter" attribute

The presenter attribute is used to associate a class of the presenter layer with a view (window, page or report).
This attribute is mainly used in the global declaration of the windows generated by the MVP RAD in WINDEV.
For example:
PROCÉDURE WIN_Table_MyExampleFile(...
gclPresenter is PTableMyExampleFile dynamic<presenter>=Null)
With this attribute, the "Request for refreshing the display" window event will be triggered by:
  • any call to RequestRefreshUI from a class declared as <presenter>,
  • any call from any class associated with the <presenter> class.
For more details, see MVP RAD: "Presenter" attribute.
Related Examples:
WM Discover MVP Cross-platform examples (WINDEV Mobile): WM Discover MVP
[ + ] This example shows the implementation of an MVP (Model View Presenter) architecture in a project. This example has been simplified to better explain the concepts of this architecture.
WD Discovering MVP - Part 1 Training (WINDEV): WD Discovering MVP - Part 1
[ + ] This educational example explains how to implement an MVP architecture (Model View Presenter) in a project. This example is simplified in order easily understand the concepts of this architecture.
WD Discovering MVP - Part 2 Training (WINDEV): WD Discovering MVP - Part 2
[ + ] This training example explains how to implement an MVP architecture (Model View Presenter) in a project for a simple analysis (Customer - Order - Order line - Product).

Several types of views (as well as their presentation) are proposed:
- table (with addition, modification, deletion and print),
- form,
- search (with filter).
Component: wd290wm.dll
Minimum version required
  • Version 25
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help