MiniRobotLanguage (MRL)
"d"-Flag "depth"
Search Child Window
Intention
This is the "depth" parameter. It needs a numeric value according to the 1.4. The Prototype Parameter System.
What is the "depth" of a child-window?
Child-windows are organized below a Top-Window because that's what makes the Child-windows. They belong to a Top-Window from an application. If that would be the whole story, all child-window would have a depth of 1.
Because that means that they are in the next level below the Top-Window. Now in reality a child window can also be below another child window. It can even for a "tree of child-windows". See the example in the picture below.
In this example, this would be some of the the window depths:
Top-Level: TaiMain.UnicodeClass | MiniRobot.sh6
1. TcxPageControl | {&NOTEXT:}
2. TcxTabSheet | EDOC
3. TcxPageControl | {&NOTEXT:}
4. TcxTabSheet | Help Topic
5. TPanel | {&NOTEXT:}
Therefore we could try to locate the TcxTabSheet|Help Topic like this:
STW.ct|TaiMain.UnicodeClass|MiniRobot.sh6 - HelpMaker 7.3.40.0
SCW.nct|1|TcxPageControl|{&NOTEXT:}
SCW.nct|1|TcxTabSheet|EDOC
SCW.nct|1|TcxPageControl|{&NOTEXT:}
SCW.nct|1|TcxTabSheet|Help Topic
MBX.#hwn#
but if we use the depth parameter, we could try this shorter version:
STW.ct|TaiMain.UnicodeClass|MiniRobot.sh6 - HelpMaker 7.3.40.0
SCW.dct|4|TcxTabSheet|Help Topic
MBX.#hwn#
which will also locate the right window.
In case there are more windows of the same window-class in the same depth, use the "n"-flag to have them numbered. Then select the right number to get the child window you want.
Short Examples:
-
Example
'
Remarks
-
Limitations:
The robot will search windows up to any depth.
See also: