SetWindowState

Description:

baSetWindowState allows you to manipulate the specified window.

Platforms:

Windows

Usage:

baSetWindowState( WinHandle, State )

Arguments:

Integer, string.
WinHandle is the handle of the window to change. To change the Director or Authorware window, use the baWinHandle() function.
State is the window's new state. Can be one of the following:

"Hidden" 

Hides the window and passes activation to another window.

"Restored" 

Activates and displays a window. If the window is minimized or maximized, it is restored to its original size and position.

"Normal" 

Activates a window and displays it in its current size and position.

"Maximised" 

Activates a window and displays it as a maximized window.

"Minimised" 

Activates a window and displays it as an icon.

"MinNotActive" 

Displays a window as an icon. The window that is currently active remains active.

"NotActive" 

Displays a window in its current state. The window that is currently active remains active.

"ShowNotActive" 

Displays a window in its most recent size and position. The window that is currently active remains active.

"StayOnTop" 

Makes the window stay on top of all other windows.

"DontStayOnTop" 

Allows the window to go behind other windows.

Returns:

Void.

Examples:

Director:
baSetWindowState( baWinHandle(), "StayOnTop" )

Authorware:
baSetWindowState( baWinHandle(), "StayOnTop" )
 

Notes:

If the WinHandle is 0, or is not the valid handle of a window, then the function will act on the active window.

 

See also:

baWindowInfo
baActivateWindow
baFindWindow