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 of the specified element (and gives back control without waiting for the execution of the event).
This function is mainly used:
  • when refreshing the UI via threads.
  • when using "container" controls: internal window, internal page, control template, supercontrol, etc.
  • when using child windows, etc.
Example
// Save process
// The UI of the child window will have to be refreshed
RequestRefreshUIElement(WIN_Child)
// -----------------------------------------------------------------
// -- Request for refreshing the display of WIN_Child
// Refresh the title of the window
MySelf.Title = gpclContactForm.p_sFullname
 
// Refresh the linked controls of the window
SourceToScreen()
Syntax
RequestRefreshUIElement(<Element> [, <Parameter 1> [... [, <Parameter N>]]])
<Element>: Window, page or control name
Element for which the "Request for refreshing the display" event must be executed. This element can correspond to the name of a window, page, internal window or page, window or page template, control template, supercontrol, etc.
<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" event of the window or control.
<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 control.
Remarks

"Request for refreshing the display" event

The "Request for refreshing the display" event contains the code for refreshing the controls of a given element: 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 at the end of the current process (asynchronous execution).
  • ExecuteRefreshUI: Immediately executes the "Request for refreshing the display" event.
  • 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".
WINDEVUniversal Windows 10 App

"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 RequestRefreshUIElement from a class declared as <presenter>,
  • any call from any class associated with the <presenter> class.
For more details, see MVP RAD: "Presenter" attribute.
Component: wd290vm.dll
Minimum version required
  • Version 27
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/11/2023

Send a report | Local help