OS_FlashWindow

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Modules > OS (Operating System) >

OS_FlashWindow

 

Description

 

Flashes the specified window one time. It does not change the active state of the window.

 

Syntax

 

OS_FlashWindow(hWnd, invert)

 

Returns

 

None

 

Parameters

 

Name

Type

Optional

Meaning

hWnd

Number

No

handle of the window to be flashed

invert

Number

No

If this parameter is TRUE, the window is flashed from one state to the other. If it is FALSE, the window is returned to its original state (either active or inactive).

 

When an application is minimized and this parameter is TRUE, the taskbar window button flashes active/inactive. If it is FALSE, the taskbar window button flashes inactive, meaning that it does not change colors. It flashes, as if it were being redrawn, but it does not provide the visual invert clue to the user.

 

Remarks

 

Flashing a window means changing the appearance of its caption bar as if the window were changing from inactive to active status, or vice versa. (An inactive caption bar changes to an active caption bar; an active caption bar changes to an inactive caption bar.)

 

Typically, a window is flashed to inform the user that the window requires attention but that it does not currently have the keyboard focus.

 

Restrictions

 

See also

 

Examples