Syntax

AppGetState[([name$])]

Description

Returns an Integer specifying the state of the top-level window.

Comments

The AppGetState function returns any of the following values:

If the window is

then AppGetState returns

Maximized

ebMaximized

Minimized

ebMinimized

Restored

ebRestored

The name$ parameter is a String containing the name of the desired application. If it is omitted, then the AppGetState function returns the name of the active application.

Examples

This example saves the state of Program Manager, changes it, then restores it to its original setting.

Sub Main()

  If AppFind$("Program Manager") = "" Then

    MsgBox "Can't find Program Manager."

    Exit Sub

  End If

  AppActivate "Program Manager"     'Activate Program Manager.

  state = AppGetState            'Save its state.

  AppMinimize                   'Minimize it.

  MsgBox "Program Manager is now minimized. Select OK to restore it."

  AppActivate "Program Manager"

  AppSetState state              'Restore it.

End Sub

See Also

AppMaximize (statement); AppMinimize (statement); AppRestore (statement).

Notes

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.

A