|
<< Click to Display Table of Contents >> Navigation: 3. Script Language > Window Operations > ITW. - If Top Window > Window Operations * ITW. / NTW. |
MiniRobotLanguage (MRL)
"E" - Flag "Exclude window"
If Top Window
Intention
Imagine you have several equal windows, which you want to handle one after the other.
Yes, there are features available to do that, for example the "r"-Flag (Window-number). Or your could use FEW.
But how about excluding those windows which you have already handled from further window searches?
To understand this you need to know that there is a Window Search "Exclude-List".
Now if you add a window to this "Exclude List", it will not be found any more. Not with STW. and not with ITW. It will be there but it will be ignored.
How do you add a window to the "Exclude List"?
STW.cE|WindowClass
MMV.
And how do you get the window out the "Exclude List"?
This is what the "I"-Flag is good for.
' Remove window from exclude List
STW.I|$$HWN
The "I"-Flag however need a window handle as parameter and will not work in any other constellation. Therefore keep the handles of those excluded windows, if you want to have them back later.
Example
' Use Exclude List
' Add window to exclude list
ITW.tE|TestAP
MMV.
VAR.$$HWN=#hwn#
' Remove window from exclude List
ITW.I|$$HWN
' If you comment the ITW. above the window can not be found here:
ITW.t|TestApp
ENR.
Remarks
Windows which have been closed, will automatically be removed from the exclude list. There is no need to remove them manually from the exclude list.
If anyway you want to remove a window from the exclude list, you can use the "I"-Flag.
To completely clear the Exclude list, use the "K"-Flag.
When locating Child-Windows using SCW. there is also Exclude-List availabe. The Exclude List for Child-Windows is a separate list and will therefore survive if you clear the exclude list for Top-Windows.
Limitations:
There are no limitations about the number of windows you may add to the exclude list.
See also: