Direct Engine Mouse-Operations

<< Click to Display Table of Contents >>

Navigation:  3. Script Language > Mouse-Operations > Direct Engine >

Direct Engine Mouse-Operations

MLE.  - Mouse-Left-Click Event

Previous Top Next


MiniRobotLanguage (MRL)

 

MLE. Command

Mouse-Left-Click Event (direct engine)

 

Direct Engine_01

 

Intention

 

This Command is the standard clicking command in automated software-installations.

 

MLE. will simulate a Left-Click (MLE.) with the Mouse using the direct engine.

 

The MLE. Command will not really  move the mouse and do the click. It will instead tell the the target application "that there was a mouse-click".

 

Therefore the target window does not need to be on top. It can even be hidden or outside of the area where the mouse can move. MLE. can click buttons which are disabled, and it can even click on invisible controls.

 

Using MLE. then the mouse pointer will  not be used. However the "action" will take place at the current "Active Point". In most cases the "Active Point" is been set, by localizing a button or control or object. In that case, the "Active Point" is in the center of the rectangular object.

You can find some more details on the "Active Point" and how to move it, here:

MAP - Move Active Point.

 

Hints:

    Like all direct engine  commands, MLE. depends on the cooperation of the target application. In some - especially JAVA-based) applications, the MLE. will not work.

    In those cases where MLE. do not works as expected, use MLC.or MLI. or MLM. .

    If you have the problem that MLE. seems to be eaten by the target application sometimes, use BSC. or BCS.

MLE. may not work on Buttons, when you have just located the Top-Window. This is normal Application behavior.

 

 

 

 

 

Syntax

 

MLE.[P1|][P2,P3]

 

 

Parameter Explanation

 

 

P1 - (optional) prototype coordinates

 

Prototype can be omitted or any of:

 

GROUP I (based on rectangular Area) Prototypes

 

"w" - choose RECT from last located Window (Child-/ or Top-Window)

"t" - choose RECT from last located Top-Window 

"k" - choose RECT from last located Child-Window 

 

"a" - choose RECT from last located Accessible Object (E8) (using SAO.,AGR.,NAV. etc.)

"g" - choose RECT from last located graphical Object (E9) (using QFR,, ANA., UNI. etc.)

"o" - choose RECT from last located Object/Window (any sort of)

"s" - use Screen-Coordinates, these will go over the whole Screen, including Dual- or Multi-Monitors

 

for these "Base-Prototypes" you can specify additionally fine-tuning using:

 - Quadrant coordinates like:

 MMV.o|{A2-B4}

 - numeric numbers (positive and negative) 

 MMV.o|-20,90

and you can combine this:

 MMV.o|-20,90 {A2-B4}

 

also there are three Prototypes that will do sort of "left-right" or "Mid" Positioning. These 3 can not be combined with each other.

 

"d" - Sort of LBO. - Positioning on the Left side of the current Rectangle.

"e" - Sort of RBO. - Positioning on the Right side of the current Rectangle.

"r" - Midpoint of the last RECT (default)

 

' Example (Combination):

 MMV.oe|-20,90 {A2-B4}

 

GROUP II (based on Point) Prototypes

"m" - actual mouse-position. Usefull if the user moves the mouse somewhere and you want to act on that position.

"b" - last mouse-position, before last Move.

"p" - current "Active Point". (Default)

"l" - Last "Active Point".

 

If prototype is omitted, Screen-Coordinates are taken.

 

"x" - Set Active Point to the Command-position.

 

Example:
' Left Click Event and Active Point Move

MLE.wrx|-358,207

 

 

P2, P3 - (optional) x,y - coordinates

    numeric coordinates, separated by comma. You can use

    variable and Formula in (..). You can also use a

    Point-Variable instead of two coordinates.

 

 

 

 

Example

 

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

' MLE.-Demo

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

STW.ct|PBWindowClass:0|TestApp

SCW.nct|2|Button|Button 2

MLE.

MLE.r|(11*5),(-1*5)

ENR.

 

 

 

Remarks

 

For automated Installations prefer BSC. where possible.

 

 

 

Limitations:

 

-

 

 

 

See also:

 

    1.C Direct Engine and Compatible Engine

    MLE. - Mouse-Left-Click Event

    MLM - Mouse Left click Move (Invinsible)

    MLI - Mouse Left Click quIckly (Invinsible)

    MRC. / MRI. - Mouse-Right-Click

    MMV - Mouse MoVe

    OPT. - Optional Settings

    BSC. - Button Special Click

    BCS. - Button Click Special