SelectRange - web automation method

IE automation method that selects a range of options in HTML multiple selection list-box web controls.

Applies to:

 
		elementObj.SelectRange(start_range, end_range);

Arguments:

start_range is the text or the ordinal position of the first option in the range to be selected.
end_range is the text or the ordinal position of the last option in the range to be selected.

Remarks:

Any previous selection in the HTML web control is removed and the options between start_range and end_range are selected.
Each of the two input parameters can be:

a number that represents the zero-based ordinal position of the option to be the limit of the range.
a string that represents the text of the option to be the limit of the range.. If useRegExp property is true, then the limit of the range must match the regular expression represented by the input string parameter.

If the speciffied range is empty (no option matches the input parameters), then a script exception is thrown and the lastError property is set to NOT_FOUND_ERROR
If the IE automation method is applied to an Element that is not a multiple selection list-box web control, then a script exception is thrown and the lastError property is set to INVALID_OPERATION_ERROR.

The time allocated for selecting the options is specified by the searchTimeout property. If loadTimeout is not zero, then the method waits the browser objects to be completely loaded in the amount of time specified by the property. If the timeout has expired the lastError property is set to LOAD_TIMEOUT_ERROR. In this case, if loadTimeoutIsError property is true, then a script exception is thrown.

Example:

// Assume nativeList is a <select multiple> HTML element.
// Select the first two items in the multiple selection list-box control.
var coreObj = new ActiveXObject("Twebst.Core");
var list    = coreObj.AttachToNativeElement(nativeList);
list.SelectRange(0, 1);