Information in this topic applies to desktop and web applications. |
Running a Low-Level Procedure From the Project Explorer Panel
Running a Low-Level Procedure as a Test Item
Running Low-Level Procedures From Scripts
Note: | You can neither pause, nor stop a running low-level procedure. |
Running a Low-Level Procedure From the Project Explorer Panel
-
Expand the Low-Level Procedures Collection item in the Project Explorer panel.
-
Right-click the desired procedure and select Run <Procedure_Name> from the context menu.
Regardless of whether the procedure was recorded for a window or for the entire screen, TestComplete will run the procedure for the entire screen. |
Running a Low-Level Procedure as a Test Item
-
Switch to the Project Explorer panel. If it is hidden, choose View | Project Explorer to make the panel visible.
-
Select your project in the Project Explorer and then select View | Organize Tests from the main menu of TestComplete. This will open the Test Items page of the project editor.
-
Drag the desired low-level procedure from the Project Explorer to the Test Items editor. This will create a new test item that runs that low-level procedure.
-
Select File | Save from the TestComplete main menu to save the changes made.
When you run the project or project suite, TestComplete will run the low-level procedure.
Regardless of whether the procedure was recorded for a window or for the entire screen, TestComplete will run the procedure for the entire screen. |
Running Low-Level Procedures From Scripts
To run a low-level procedure from a script test, use the LowLevelProcedure.Execute
method.
For example:
JavaScript, JScript
LLCollection1.LLP1.Execute();
Python
LLCollection1.LLP1.Execute()
VBScript
LLCollection1.LLP1.Execute
DelphiScript
LLCollection1.LLP1.Execute;
C++Script, C#Script
LLCollection1["LLP1"]["Execute"]();
If you call the Execute
method without any parameters, TestComplete will run the procedure for the entire screen (that is, event coordinates recorded by the procedure will be treated as screen coordinates).
To run a procedure for an individual window, pass the appropriate window
object to the Execute
method. TestComplete will treat coordinates stored by low-level procedures as window-relative coordinates:
JavaScript, JScript
var w = Sys.Process("MyProcess").Window("MyWndClass", "MyWndCaption",1); // Obtains the window
LLCollection1.LLP1.Execute(w);
Python
w = Sys.Process("MyProcess").Window("MyWndClass", "MyWndCaption",1) # Obtains the window
LLCollection1.LLP1.Execute(w)
VBScript
Set w = Sys.Process("MyProcess").Window("MyWndClass", "MyWndCaption",1) ' Obtains the window
Call LLCollection1.LLP1.Execute(w)
DelphiScript
var w;
begin
w := Sys.Process('MyProcess').Window('MyWndClass', 'MyWndCaption',1); // Obtains the window
LLCollection1.LLP1.Execute(w);
end;
C++Script, C#Script
var w = Sys["Process"]("MyProcess")["Window"]("MyWndClass", "MyWndCaption",1); // Obtains the window
LLCollection1["LLP1"]["Execute"](w);
Running Low-Level Procedures From Keyword Tests
You run low-level procedures from keyword tests in the same way you do it from script tests, by using the LowLevelProcedure.Execute
method. To call the method from a keyword test, use the Call Object Method operation.
Converting Low-Level Procedures to Script Code
To learn how to convert a low-level procedure into a set of script statements and then run the generated code, see Parameterizing Low-Level Procedures.
See Also
LowLevelProcedure Object
Parameterizing Low-Level Procedures
LLPlayer Object
Window- and Screen-Relative Low-Level Procedures
Testing Applications in Low-Level Mode