<< Click to Display Table of Contents >> Navigation: 3. Script Language > Window Operations > Window Operations |
MiniRobotLanguage (MRL)
IWV. Conditional Statement
If Window Visible
Intention
Conditional Statement.
Test if one or more specified window(s) are visible or not. If no parameter is given, the actual window is been tested.
You can make windows (includes child-windows) visible or invisible using the SWS. - Set Window State .-command.
IWV. tells you, if the actual window is visible or has been made invisible. If no parameter is given, the actual window is been tested. If you give parameter, these must be window handles, or the letters "c" or "t".
These letters stand for "child" and "Top". If given they will be replaced with the last window of that kind that has been localized.
c - last localized child-window
t - last localized Top-Window
Please note, that if the actual window is a child-window (e.g. a button), you need to specify "t" as parameter,if you want to test the actual top-window. Some examples:
'Get first window handle
STW.ct|CabinetWClass|c:
HTV.$$HAA
'Get second window handle
STW.ct|Chrome_WidgetWin_0|meebo.com
HTV.$$HAB
'Test both handles
IWV.$$HAA|$$HAB
DBP.All windows are visible
ELS.
DBP.At least one of the windows is invisible
EIF.
ENR.
Other modes of operation are:
' Check actual located window
IWV.
' check last located child window
IWV.c
' check actual Top-window
IWV.t
' check window with handle in $$MYH
IWV.$$MYH
NWV. is the negative version "Not Window Visible".
Syntax
IWV.[P1][|P2...|P20]… ELS. … EIF.
Parameter Explanation
P1 - numeric/variable or "c" or "t". If omitted actual
window is taken.
P2 - optional parameters which are also tested for enabled.
If one of them is disabled the test fails (implicit=AND).
Can be up to 20 additional parameters.
IWV.'s can be nested to unlimited Depth, and they can also enclose Sub-Program Calls or FEX. (Enumerations) to unlimited Depth.
Example
'***********************************
' IWV.-Sample
'***********************************
STW.t|Sample
MMV.
IWV.
MBX.Ok
ELS.
MBX.No
EIF.
END.
Remarks
-
Limitations:
-
See also:
• IWS. / NWS. - If Window State
• IWV. / NWE. - If Window Enabled
• IWI. / NWI. - If Window Iconized
• IWZ. / NWZ. - If Window Zoomed