![]() ![]() ![]() ![]() |
![]() ![]() ![]()
| Topics this page:
|
Related Topics: |
| ![]() ![]() ![]() |
This is reorganized from WinRunner User's Guide Part VI - "Working with the GUI Map" - "Configuring the GUI Map" - "Understanding WinRunner Objects Classes".
Links are provided to my page detailing specific functions.
|
Type | Class Name | Description | ActiveX Name |
---|---|---|---|
Window | window ![]() | Any application window, dialog box, or form, including MDI windows. | |
frame_mdiclient | Enables WinRunner to treat a window as an mdiclient object. | ||
mdiclient | An mdiclient object. | ||
mic_if_win | Enables WinRunner to defer all record and run operations on any object within this window to the mic_if library described in the WinRunner Customization Guide. | ||
Text Items ![]() | status bar | A status bar on a window. | |
static_text | Display-only text not part of any GUI object. | ||
edit | A text input field. | EditBox | |
list | Pull-down menu selection | ListBox | |
Graphic/ Controls ![]() | check_button | A check box. | CheckBox |
push_button | A push (command) button. | ||
radio_button | A radio (option) button. | ||
menu_item | A menu item. | ||
scroll | A scroll bar or slider. | ||
tab | A tab item. | ||
toolbar | A toolbar object. | ToolbarWindow32 | |
Special Controls ![]() | calendar | A standard MSW calendar object. | CDateTimeCtrl or CMonthCalCtrl |
spin | A spin object. | ||
Generic | object - Any object not included in one of the classes described here. |
| ![]() ![]() ![]() |
This is reorganized from WinRunner User's Guide Part VI - "Working with the GUI Map" - "Configuring the GUI Map" - "Understanding Object Properties"
|
Type | Property | Description |
---|---|---|
ID | class | The GUI objects classes recognized by WinRunner [above] |
class_index | An index number that identifies an object, relative to the position of other objects from the same class in the window (Java add-in only). | |
handle | A run-time pointer to the object: the HWND handle. | |
MSW_class | The Microsoft Windows class. | |
regexp_MSWclass | The Microsoft Windows class combined with a regular expression. Enables WinRunner to identify objects with a varying MSW_class. | |
MSW_id | The Microsoft Windows ID. | |
TOOLKIT_class | The value of the specified toolkit class. The value of this property is the same as the value of the MSW_class in Windows, or the X_class in Motif. | |
owner | (For windows), the application (executable) name to which the window belongs. | |
vb_name | A text string assigned to Visual Basic objects by the developer (the name property). (The property applies only to WinRunner with Visual Basic add-in support.) | |
pb_name | A text string assigned to PowerBuilder objects by the developer. (The property applies only to WinRunner with PowerBuilder add-in support.) | |
obj_col_name | A concatenation of the DataWindow and column names. For edit field objects in WinRunner with PowerBuilder add-in support, indicates the name of the column. | |
module_name | The name of an executable file which created the specified window. | |
Text | text | The visible text in an object or window. |
attached_text | The static text located near the object. | |
label | The text that appears on the object, such as a button label. | |
regexp_label | The text string and regular expression that enables WinRunner to identify an object with a varying label. | |
Rank | parent | The logical name of the parent of the object. |
nchildren | The number of children the object has: the total number of descendants of the object. | |
count | The number of menu items contained in a menu. | |
position | The position (top to bottom) of a menu item within the menu (the first item is at position 0). | |
num_columns | A table object in Terminal Emulator applications only. | |
num_rows | A table object in Terminal Emulator applications only. | |
Number | abs_x | The horizontal x-coordinate of the top left corner of an object, relative to the origin (upper left corner) of the screen display. |
abs_y | The vertical y-coordinate of the top left corner of an object, relative to the origin (upper left corner) of the screen display. | |
x | The horizontal x-coordinate of the top left corner of an object, relative to the window origin. | |
y | The vertical y-coordinate of the top left corner of an object, relative to the window origin. | |
height | Height up/down an object, in screen pixels. | |
width | Width across an object, in screen pixels. | |
Boolean | active | 1 indicates this is the top-level visible window associated with input focus. |
displayed | 1 indicaties this object is displayed, visible on screen, 0 if not. | |
enabled | 1 indicates the object can be selected or activated, 0 if not. | |
focused | 1 indicates whether keyboard input will be directed to this object, 0 if not. | |
maximizable | 1 indicates the window can be maximized, 0 if not. | |
minimizable | 1 indicates the window can be minimized, 0 if not. | |
submenu | 1 indicates this menu item has a submenu, 0 if not. | |
sysmenu | 1 indicates the menu item is part of a system menu, 0 if not. | |
Mixed | value | Different for each class:
Radio and check buttons: 1 if the button is checked, 0 if not. Menu items: 1 if the menu is checked, 0 if not. List objects: indicates the text string of the selected item. Edit/Static objects: indicates the text field contents. Scroll objects: indicates the scroll position. All other classes: the value property is a null string. |
| Note: The links to documents which used to be here were removed at the request of Mercury Interactive lawyers. I guess they don't want people to know about their software. God forbid that anyone actually can figure out how to use their product. | ![]() ![]() ![]() |
| These are Customization Guide "custom.pdf" file. | ![]() ![]() ![]() |
|
| ![]() ![]() ![]() |
|
Error Code | Named constant | object |
---|---|---|
-10002 | E_NOT_FOUND | window |
-10003 | E_NOT_UNIQUE | (in gui map) |
-10005 | E_OUT_OF_RANGE | |
-10011 | E_NOT_IN_MAPPING | (GUI map) |
-10105 | E_ITEM_NOT_FOUND | within a list |
-10101 | E_NOT_DISPLAYED |
Constants such as E_OK have names defined in file
hlerr.h
which maps to a set of "internal constants" such as "MIC_E_OK" defined with actual values (such as 0) in header file
mic.h
(so named because MIC is an acronymn for "Mercury Interactive Corporation").
This is referenced in the mic_if.h file, all within the custom\mic_if folder where
WinRunner is installed. The short names of error codes are defined there.
If you do, menu_select_item will not recognize the pop-up menu.
Instead, set a stop after the item is selected in menu_select_item and execute "From Arrow" rather than one step at a time (with the default F6 key).
The variable my_results_lvl controls how much information is sent to the results table.
1 = Error and warning messages only.
2 = Run environment, count of records in files used, start/end time, plus the above.
3 = Every data table record at each step plus all of the above.
1 = At file level error conditions only.
2 = At each error in the script.
3 = At each data table record read and successfully processed as well as all the above.
Sample code:
if( my_pause_lvl>= 3 ) pause( tl_msg );
if( my_pause_lvl>= 3 ) pause( tl_msg );
Marshall Brain's How Stuff Works focuses on common misunderstandings.
| . | ![]() ![]() ![]() |
| ![]() ![]() ![]() |
| . | ![]() ![]() ![]() |
![]()
| Your first name: Your family name: Your location (city, country): Your Email address: |
Top of Page ![]() Thank you! |