AppRestore (statement)


AppRestore [name$]


Restores the named application.


The name$ parameter is a String containing the name of the application to restore. If this parameter is omitted, then the active application is restored.


This example minimizes Program Manager, then restores it.

Sub Main()

  If AppFind$("Program Manager") = "" Then Exit Sub
  AppActivate "Program Manager"
  AppMinimize "Program Manager"
  MsgBox "Program Manager is now minimized. Press OK to restore it."
  AppRestore "Program Manager"
End Sub

See Also

AppMaximize (statement); AppMinimize (statement); AppMove (statement); AppSize (statement); AppClose (statement).


The name$ parameter is the exact string appearing in the title bar of the named application's main window. If no application is found whose title exactly matches name$, then a second search is performed for applications whose title string begins with name$. If more than one application is found that matches name$, then the first application encountered is used.

AppRestore will have an effect only if the main window of the named application is either maximized or minimized.

AppRestore will have no effect if the named window is hidden.

AppRestore generates a runtime error if the named application is not enabled, as is the case if that application is currently displaying a modal dialog box.

More information