|
<< Click to Display Table of Contents >> Navigation: 3. Script Language > Window Operations > STW. - Search Top Window > Window Operations * STW. |
MiniRobotLanguage (MRL)
"K" - Flag "Clear Exclude List"
Clear Exclude List and search
Intention
Immediately clear Exclude-List before specified search.
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 search windows which are currently excluded from search?
This is what the "K"-Flag is good for.
' clear whole exclude List
STW.Kc|WindowClass
The "K"-Flag will immediately, even before the search starts, clear the exclude list. No matter if a window is found or not, using the prototype "K" will clear the exclude list.
After this all previously "exclude listed" windows can be found again.
Example
' Use Exclude List
' Add window to exclude list
STW.Et|TestApp
MMV.
VAR.$$HWN=#hwn#
' Remove all windows from exclude List
' and search
' If you remove the "K" below, the window can not be found!
STW.Kt|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 available. The Exclude List for Child-Windows is a separate list and will therefore survive if you clear the exclude list for Top-Windows.
Currently you can not check which windows are exclude-listed. There is also no way of showing the content of an exclude-list.
Limitations:
There are no limitations about the number of windows you may add to the exclude list.
See also: