ExecuteRefreshUI

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

"Request for refreshing the display" event
MVP: Presentation 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.

Note: This function is used in particular:

when refreshing the interface via threads.
when using MVP (Model - View - Presenter) programming. For more details, see MVP Presentation: 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 together the update code for window (or page) fields: field content, status (visible, grayed-out, etc.), label to be updated, 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 "Display update request" event for 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".

Note: The "Display update request" event can also be executed immediately with the ExecuteProcess function, using the following syntax:

ExecuteProcess(<Element name>, trtRequestRefresh)

MVP: Presentation 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:

PROCEDURE 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 RAD MVP: "presentation" 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