PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK

  • Finding out the value returned by a child window
  • Limits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
..ReturnedValue is used to:
  • Find out and modify the value returned by a window, a page or a report.
  • Find out and modify the value returned by an option in a Radio Button control.
Windows Mobile Reminder: A window opened by Open may return a result when it is closed. This value is returned:
  • by the Result keyword in the window closing code,
  • by Close,
  • by ..ReturnedValue used before closing the window.
AndroidiPhone/iPadUniversal Windows 10 App When used on the MyChildWindow keyword, the ...ReturnedValue property allows retrieving the value returned by a child window in a mobile application.
Versions 19 and later
iPhone/iPadUniversal Windows 10 AppWindows Mobile Reminder: A report printed by iPrintReport may return a result at the end of its print. This value is returned:
  • by the Result keyword in the report closing code,
  • by ..ReturnedValue used before closing the report.
New in version 19
iPhone/iPadUniversal Windows 10 AppWindows Mobile Reminder: A report printed by iPrintReport may return a result at the end of its print. This value is returned:
  • by the Result keyword in the report closing code,
  • by ..ReturnedValue used before closing the report.
iPhone/iPadUniversal Windows 10 AppWindows Mobile Reminder: A report printed by iPrintReport may return a result at the end of its print. This value is returned:
  • by the Result keyword in the report closing code,
  • by ..ReturnedValue used before closing the report.
Versions 15 and later
Android This property is now available for Android applications.
New in version 15
Android This property is now available for Android applications.
Android This property is now available for Android applications.
Versions 17 and later
iPhone/iPad This property is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for iPhone/iPad applications.
iPhone/iPad This property is now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store Apps mode.
Android Widget This property is now available in Android Widget mode.
New in version 18
Universal Windows 10 App This property is now available in Windows Store Apps mode.
Android Widget This property is now available in Android Widget mode.
Universal Windows 10 App This property is now available in Windows Store Apps mode.
Android Widget This property is now available in Android Widget mode.
Versions 21 and later
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Example
Windows Mobile
// Code used to open the "WIN_EditPassword" window
MyPassword = Open(WIN_EditPassword)
IF MyPassword <> "" THEN
Info("Wrong password")
END
 
// --------------------------------------------------------------------------------
// -- Click code on the "OK" Button control in "WIN_EditPassword"
// The user types his password in the "EDT_Password" control
// and validates the window
Close()
 
// --------------------------------------------------------------------------------
 
// -- Closing code of the window
WIN_EditPassword..ReturnedValue = EDT_Password
Versions 18 and later
AndroidiPhone/iPadUniversal Windows 10 App
// Event "Closing a child window of WIN_List_Customers"
// -------------------------------------------------------------
// Refreshes the list of customers
LooperDisplay(LOOP_Customers, taReExecuteQuery)
 
// For any return (except for the deletion)
IF MyChildWindow..ReturnedValue <> -1 THEN
nSubscript is int
// Finds the customer row
nSubscript = LooperSeek(ATT_CustomerNum, Customer.CustomerNum)
IF nSubscript > 0 THEN
// Positions on the customer row
LooperPosition(LOOP_Customers, nSubscript)
END
END
New in version 18
AndroidiPhone/iPadUniversal Windows 10 App
// Event "Closing a child window of WIN_List_Customers"
// -------------------------------------------------------------
// Refreshes the list of customers
LooperDisplay(LOOP_Customers, taReExecuteQuery)
 
// For any return (except for the deletion)
IF MyChildWindow..ReturnedValue <> -1 THEN
nSubscript is int
// Finds the customer row
nSubscript = LooperSeek(ATT_CustomerNum, Customer.CustomerNum)
IF nSubscript > 0 THEN
// Positions on the customer row
LooperPosition(LOOP_Customers, nSubscript)
END
END
AndroidiPhone/iPadUniversal Windows 10 App
// Event "Closing a child window of WIN_List_Customers"
// -------------------------------------------------------------
// Refreshes the list of customers
LooperDisplay(LOOP_Customers, taReExecuteQuery)
 
// For any return (except for the deletion)
IF MyChildWindow..ReturnedValue <> -1 THEN
nSubscript is int
// Finds the customer row
nSubscript = LooperSeek(ATT_CustomerNum, Customer.CustomerNum)
IF nSubscript > 0 THEN
// Positions on the customer row
LooperPosition(LOOP_Customers, nSubscript)
END
END
Syntax

Finding out the returned value Hide the details

<Result> = <Element used>..ReturnedValue
<Result>: Any type
Value that will be returned:
  • when closing the current window, page or report.
  • if the option is selected in the radio button.
<Element used>: Name of window, page, report, option
Name of element used:
  • Name of the window, page, report or internal report used. This window, page or report must be opened.
  • Name of the option in the radio button. This name has the following format: <Radio Button control>[<Option number>].

Modifying the returned value Hide the details

<Element used>..ReturnedValue = <New value>
<Element used>: Name of window, page, report, option
Name of element used:
  • Name of the window, page or report used. This window, page or report must be opened.
  • Name of the option in the radio button. This name has the following format: <Radio Button control>[<Option number>].
<New value>: Any type
New value to return. The following types can be used:
  • structure
  • dynamic structure
  • class
  • advanced type
  • array
  • associative array
  • queue
  • stack
  • list
Remarks
Versions 18 and later
AndroidiPhone/iPadUniversal Windows 10 App

Finding out the value returned by a child window

In the mobile applications, the windows are opened by OpenMobileWindow (or OpenChild) instead of Open.
It is possible to know the value returned by a child window in the event "Closing a child window" of the window that opened the child window (the one that called OpenMobileWindow or OpenChild).
For example:
  • In the closing code of the child window, Close is used to return a parameter:
    Close("", MyParameter)
  • The name of the child window as well as the returned value can be retrieved in the event "Closing a child window" of the calling window, using the MyChildWindow keyword:
    // Close a child window
    NameChildWindow = MyChildWindow..Name
    ValueChildWindow = MyChildWindow..ReturnedValue
New in version 18
AndroidiPhone/iPadUniversal Windows 10 App

Finding out the value returned by a child window

In the mobile applications, the windows are opened by OpenMobileWindow (or OpenChild) instead of Open.
It is possible to know the value returned by a child window in the event "Closing a child window" of the window that opened the child window (the one that called OpenMobileWindow or OpenChild).
For example:
  • In the closing code of the child window, Close is used to return a parameter:
    Close("", MyParameter)
  • The name of the child window as well as the returned value can be retrieved in the event "Closing a child window" of the calling window, using the MyChildWindow keyword:
    // Close a child window
    NameChildWindow = MyChildWindow..Name
    ValueChildWindow = MyChildWindow..ReturnedValue
AndroidiPhone/iPadUniversal Windows 10 App

Finding out the value returned by a child window

In the mobile applications, the windows are opened by OpenMobileWindow (or OpenChild) instead of Open.
It is possible to know the value returned by a child window in the event "Closing a child window" of the window that opened the child window (the one that called OpenMobileWindow or OpenChild).
For example:
  • In the closing code of the child window, Close is used to return a parameter:
    Close("", MyParameter)
  • The name of the child window as well as the returned value can be retrieved in the event "Closing a child window" of the calling window, using the MyChildWindow keyword:
    // Close a child window
    NameChildWindow = MyChildWindow..Name
    ValueChildWindow = MyChildWindow..ReturnedValue

Limits

..ReturnedValue applies to:
  • AndroidAndroid Widget Universal Windows 10 AppWindows Mobile windows,
  • AndroidUniversal Windows 10 AppWindows Mobile options found in Radio Button controls.
  • Versions 20 and later
    iPhone/iPadUniversal Windows 10 AppWindows Mobile reports.
    New in version 20
    iPhone/iPadUniversal Windows 10 AppWindows Mobile reports.
    iPhone/iPadUniversal Windows 10 AppWindows Mobile reports.
  • Versions 20 and later
    iPhone/iPadUniversal Windows 10 AppWindows Mobile internal reports (in read-only).
    New in version 20
    iPhone/iPadUniversal Windows 10 AppWindows Mobile internal reports (in read-only).
    iPhone/iPadUniversal Windows 10 AppWindows Mobile internal reports (in read-only).
Related Examples:
Popup calendar Unit examples (WINDEV): Popup calendar
[ + ] Using a calendar that can be used by the OpenPopup function.
The PopCalendar window is very useful in the applications containing date controls.
Indeed, the PopCalendar window allows you to choose a date visually.
The risk of error is reduced as the user can see the day of the week corresponding to the selected date.
Then, the date control is filled with the value returned by the PopCalendar window.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment