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.
|