When called from the "Request for refreshing the display" event of a supercontrol, a control template, an internal window or an internal page, the function immediately executes the "Request for refreshing the display" event of the higher level. (This usually means the window, but it can also be a supercontrol, control template, internal window or internal page).
If the function is called several times during an event, the refresh event will be run several times.
Remark: This function is mainly used:
Versions 24 and later
New in version 24Syntax
ExecuteRefreshUIParent([<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 windows, internal windows, pages, page templates, control templates and supercontrols is "Request for refreshing the display". This event is used to group the code for refreshing the controls: contents of controls, state (visible, grayed out...), text to refresh, etc.
This event can receive parameters. Simply declare a procedure in the process. For example:
// Request for refreshing the display
PROCEDURE AskForRefresh(RefreshType is boolean)
This event is run 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.
Versions 27 and laterRequestRefreshUIElement: Executes the "Request for refreshing the display" event of the given element at the end of the current process (asynchronous execution).
New in version 27RequestRefreshUIElement: Executes the "Request for refreshing the display" event of the given element at the end of the current process (asynchronous execution).
RequestRefreshUIElement: Executes the "Request for refreshing the display" event of the given element at the end of the current process (asynchronous execution).
Versions 27 and laterExecuteRefreshUIElement: Immediately executes the "Request for refreshing the display" event of the given element.
New in version 27ExecuteRefreshUIElement: Immediately executes the "Request for refreshing the display" event of the given element.
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 the event.
Remark: The "Request for refreshing the display" event can also be immediately executed by
ExecuteProcess with the following syntax:
ExecuteProcess(<Element name>, trtRequestRefresh)