ShowForm
This will immediately call the requested form and hold script execution on that line until the user exits the displayed form. App.ShowFormis intended to display things like a Search form, Error form, Detailed information, etc. where you want to pause current form execution, display / capture input from the other form, then return and continue processing. In other words, App.ShowForm lets you call another application without having to complete the current application's execution where as in the App.CallForm language extension, the current app execution must complete before calling another app form.
When you use ShowForm, your script that executes the command to show the form must originate from the root (original) form. If the requested form displayed and completed its OnUpdate event, then App.ShowForm returns True. If it doesn't then it returns False.
You can also use the Options parameter to load default values. (Options is like a GetValue function.)
Group: Application-Based Extensions
Syntax App.ShowForm [name], [options]
FormName (String) The name of the other application form to be displayed.
FormOptions (This value is not used at this time.
Example
Option Explicit
Dim bool As Boolean
Private Sub Button1_Click() On Error Resume Next
bool = App.ShowForm("ShowedFormModified")
App.MsgBox("App.ShowForm returns " & bool)
End Sub
Private Sub Form_OnUpdate(ByRef Cancel As Boolean) On Error Resume Next
App.MsgBox("App.ShowForm returns " & bool)
End Sub
Option Explicit
Private Sub Form_OnUpdate(ByRef Cancel As Boolean) On Error Resume Next
App.ExitForm
End Sub
Version Supported: RFgen 5.2.4.0 and newer.