<Element>.RequestRefreshUI (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

New WINDEV, WEBDEV and WINDEV Mobile 28 feature!

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

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Element>.RequestRefreshUI (Function)

In french: <Elément>.DemandeMiseAJourUI

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.

New in version 28

This function is now available for Android applications.

Example

// Save process
// The UI of the child window will have to be refreshed
WIN_Child.RequestRefreshUI()

// -----------------------------------------------------------------
// -- 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

<Element>.RequestRefreshUI([<Parameter 1> [... [, <Parameter N>]]])

<Element>: 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:

<Element>.RequestRefreshUI: Executes the "Request for refreshing the display" event of the given element at the end of the current process (asynchronous execution).
<Element>.ExecuteRefreshUI: 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".

"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 <Element>.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.

Component: wd280vm.dll