std
Script emos_std_list_lib

CompiledModule
  |
  +--emos_std_list_lib

This library contains alternative implementations of standard functions that operate on list objects (list_x() functions). Reasons for alternative implementations can be various. They should be carefully documented with each function. Another sort of functions in this library are functions that implement some additional functionality that would probably fit into Mercury's logic for list_x() functions.

Tsl

emos_std_list_lib.tsl

Function Summary

String	list_item_exists(in obj, in regex, out pos, in soft) Checks whether the list contains a particular item.
String	list_select_item1(in obj, in item) This function was created as an attempt to solve a particularly ugly bug in WR 6.0 / 6.02.

Function Detail

list_item_exists

public String list_item_exists(in obj,
                               in regex,
                               out pos,
                               in soft)

Checks whether the list contains a particular item. You can search for items that must exactly match the search string str1 or contain the searched substring.

Parameters:

obj - (in) list object to be searched

regex - (in) string to search for

pos - (out) item number in case was found

soft - (in) (optional) TRUE = matches a substring FALSE = exact match [default: FALSE]

Returns:

E_OK: match found E_NOT_FOUND: match not found else: errors detected

list_select_item1

public String list_select_item1(in obj,
                                in item)

This function was created as an attempt to solve a particularly ugly bug in WR 6.0 / 6.02. It is obsolete now because we have discovered the real cause of the problem which you can solve by placing set_var("timeout",10) in your startup script. We have left the function in the library to show one way how some problems could be aproached by applying alternative methods to achieve the "same" effect. In this case we rely on the fact that MFC listboxes typically position the focus on the item whose name starts with the key pressed. So we are pressing the initial key until we either find an item or we "cycle- through" the list.

PROBLEM DESCRIPTION:

Hier and then we had the problem that after restarting WinRunner, list objects wouldn't work properly. For some reason list_select_item() would suddenly not work although the item was still there and neither application nor the test (that's what we thought) changed. GUI editor would show no problems whatsoever with any of the list objects. Only the selecting would not work. The only way to "solve" the problem was to re-install WinRunner. Finally, after days of searching,, we have discovered, that after some WinRunner crashes, the default timeout value (saved in wrun.ini, where else) had a value of 10 instead of 10000. This has explained why this problem only occurs in WR 6.0. It is 6.0 when timeout was changed from seconds to miliseconds. Obviously, somewhere deep in some WinRunner dll there is still a peace of logic that thinks in seconds instead of miliseconds. Since we know what Mercury could claim, we have checked our test scripts - they are deffinitely fine. It is WinRunner who causes problems.

PROBLEM SOLUTION:

There are several solutions for this problem:

• You change the wrun.ini each time this happens.
• You wait until Mercury fixes the problem.
• You (re)set the timeout you want in your startup script.

Obviously, the last one is the only feasible.

Parameters:

obj - (in) name of the list object

item - (in) item which is to be selected

Returns:

E_OK: success !E_OK: error