I’ve been doing some digging into QTP’s test-objects, hoping to find some undocumented methods and techniques. Armed with the power of PDM.DLL, I’ve explored each test object, and have come up with these interesting results, all of which don’t show up on your regular intellisense autocomplete.
As this is still a work in process, the function of many methods is still unclear. I’ve set up a color coding system to make things more clear – Red = Don’t have a clue. Black = Have a pretty good idea / an educated guess. Green = Presumably know exactly what the method is supposed to do.
If any of you know the purpose and function of these methods, please fill me in by dropping a comment, and I’ll update the article.
Update: mayno224 has informed us that a Java object MethodWizard method will open a window with all the object’s internal methods (similar to the .Net form’s spy).
All Objects
All QTP test objects have these five methods in common:
1. Highlight – Highlights the object, much like the highlight feature in the object-repository.
2. QueryValue(Property, PropertyData), GetProperty(Property, pFlags, pType, pParameterName) and SetProperty(Property, Value, pFlags, pType, pParameterName)– I haven’t been able to figure out what these method do. If any of you manage to crack this up, I would appreciate it if you dropped a comment.
3. ToString – Returns a string representation of the object. Usually it’s just the name.
4. Init – As described here, re-links the test-object to the runtime object. Especially useful in a web environment, after a page refresh.
Web
All Objects:
Method |
Description |
.MakeObjVisible | Scrolls the object into view (if needed). Similar to the documented .MakeVisible method for ActiveX objects |
Browser:
Method |
Description |
.AddCookie(Domain, Cookies) .GetCookies(Url, Cookies) |
Probably syntactically sets / gets cookie data. |
.RefreshWebSupport | Perhaps the underlying method behind the visible .Refresh method? |
.SubmitForm(bstrUrl, bstrTargetFrame, bstrPostData, bstrHeaders) | Submit forms “hardcore” style. |
Page:
Method |
Description |
.RefreshObjects | Probably performs .Init on all its childobjects. |
.StartTransaction(Name) .EndTransaction(Name, Status) .SetTransactionStatus(Status) |
Don’t have a clue. |
.SaveLayout(pDoc) .RestoreLayout(elemTag, elemID, propName, propValue) |
Presumably saves/restores the visible layout of the page. |
All other web objects (WebElement, WebList, WebButton, etc.):
Method |
Description |
.Submit | Presumably submits a form, if activated on the relevant object |
.MouseOver | Similar to firing the OnMouseOver event. |
Standard Windows
All Objects:
Method |
Description |
ClickOnText(TextToFind, Left, Top, Right, Bottom, MatchWholeWordOnly, BUTTON, DoubleClick) | Extremely useful method! A merge between .GetTextLocation and .Click: It finds the specified text within the object, and clicksAll the parameters are self-explanatory. BUTTON is the button code (look under the click method in QTP help); and DoubleClick is boolean. |
WinEdit:
Method |
Description |
.SetText | Seems to be exactly like the regular .Set method. However, Neither function uses the other (checked with RegisterUserFunc) |
WinButton:
Method |
Description |
.Press | Seems to be exactly like the regular .Click method. However, Neither function uses the other (checked with RegisterUserFunc) |
WinMenu:
Method |
Description |
.PrepareMenu(phSubMenu, peMenuObjectType) | Perhaps has something to do with loading the sub-menu items for a given menu option. |
.Net (SWF objects)
All Objects:
Method |
Description |
ClickOnText(TextToFind, Left, Top, Right, Bottom, MatchWholeWordOnly, BUTTON, DoubleClick) | Same as in Standard Windows. |
Spy | Launches the .Net form spy for the relevant object. Perfect for objects you cannot get your mouse to point to. |
CreateManagedObject(bsType, bsFile, pVal) | Have no idea. |
SwfTable:
Method |
Description |
GetCellCoord(Row, Column, X, Y) | Probably the underlying method behind ClickCell. Should return the cell coordinates though the ByRef X,Y variables, but keeps spitting out an error (Perhaps the variables have to be cased into long integers?). |
SwfButton:
Method |
Description |
.Press | Seems to be exactly like the regular .Click method. However, Neither function uses the other (checked with RegisterUserFuc) |
.Java
All Objects:
Method |
Description |
InvokeMethod(MethodName, MethodArguments) | My guess is it calls an inner method of the object. |
MethodWizard() | Thanks to Mayno224: Will present a screen with all the object’s internal methods. Kinda similar to .Net objects Spy. |
RequestFocus() | Presumably brings the object into focus. |
ClickOnText(TextToFind, Left, Top, Right, Bottom, MatchWholeWordOnly, BUTTON, DoubleClick) | Same as in Standard Windows. |
Other environments and updates will be published when I’ve completed my investigation, and when reads will drop in more information through comments.