3. Script Language > Window Operations > IWS. / NWS.

IWS. / NWS. - If Window State

Previous Top Next

MiniRobotLanguage (MRL)

IWS. Conditional Statement

If Window State

Intention

Conditional Statement.

What is a "windows state"?

• windows can be

• enabled, disabled

• minimized, normal

• maximized

• visible or invisible

Test these windows states using IWS.

Using IWS. you can test the last localized or any specified child- or top-window for its states.

As you can specify multiple states, you can completely check out a window in one run.

IWS. is the counterpart to SWS. Using SWS. - Set Window State you can set the states of a window.

If no parameter is given, the actual window is been tested.

NWS. is the negative version "Not Window State".

Syntax

IWS.[P1][|P2]… ELS. … EIF.

Parameter Explanation

P1 - prototype

Use the following letters for P1:

' e - enabled

' d - disabled

' v - visible

' i - invisble

' m - minimzed

' n - normal (not minimized)

' z - zoomed (maximized)

' u - unzoomed

' t - use actual Top-Window instead of actual window

If no parameters are specified, "evn" is taken to the actual window.

Multiple states can be given. In that case they are connected with AND. All given states MUST be set as given to let the condition evaluate to true.

P2 - (optional) parameter which can be a window-handle.

When given, this window is tested.

Example

'***********************************

' IWS./NWS.-Sample

'***********************************

STW.t|Sample

MMV.

IWS.ev

MBX.Ok

ELS.

MBX.No

EIF.

STW.t|Sample

HTV.$$HWN

STW.t|anotherwindows

MMV.

' Note that the first window is going to be tested.

IWS.ev|$$HWN

MBX.Ok

ELS.

MBX.Diabled!

EIF.

END.

Remarks

Limitations: