ExecuteRefreshUI

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Window functions

"Request for refreshing the display" event
MVP: "Presenter" attribute

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ExecuteRefreshUI

In french: ExécuteMiseAJourUI

Immediately executes the "Request for refreshing the display" event of the window, page, internal window, internal page, control template or supercontrol.

If the function is called several times during a process, the refresh event will be run several times.

Remark: This function is mainly used:

when refreshing the interface via threads.
when using MVP (Model - View - Presenter) programming. For more details, see MVP overview: Model - View - Presenter.

Example

ExecuteRefreshUI()

Syntax

ExecuteRefreshUI([<Parameter 1> [... [, <Parameter N>]]])

<Parameter 1>: Type of value 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 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 is used to group the code for refreshing the window (or page) controls: contents of controls, state (visible, grayed out...), text to refresh, etc.

This event can receive parameters. Simply declare a procedure in the event. For example:

// Request for refreshing the display
PROCEDURE 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".

Remark: The "Request for refreshing the display" event can also be immediately executed by ExecuteProcess with the following syntax:

ExecuteProcess(<Element name>, trtRequestRefresh)

MVP: "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.

For example:

PROCÉDURE WIN_Table_MyExampleFile(...
gclPresenter is PTableMyExampleFile dynamic <presenter>=Null)

When this attribute is used, the call to the "Request for refreshing the display" event of the window (or page) 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:

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.

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.

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: wd300.dll