See also:  setOptionAttributes, setOptionValue, setSelectedOption, setSelectedOptionByValue, setSelectedOptionByText, getSelectIndexByValue, getSelectIndexByText, getSelectOptionText, getSelectOptionValue

Function used to set the text of an option associated with a given SELECT object.

Syntax

JSV_setOptionText(selectObj, optionIndex, optionText)

Prototype

n/a

Returns

n/a

Parameters

The setOptionText function uses the following arguments.

Argument Description
selectObj The SELECT object.
optionIndex An integer specifying the index of the selected option in a SELECT object.
optionText Specifies the text to display in the select list.

Remarks

n/a

Dependencies

n/a

Example

The following lines of code

<FORM ACTION="setOptionText.html" NAME="SelectTest" ID="SelectTest" onSubmit="return false;">
<SELECT NAME="ChangeSelect" ID="ChangeSelect" SIZE="1">
<OPTION VALUE="1" SELECTED>One</OPTION>
<OPTION VALUE="2">Two</OPTION>
<OPTION VALUE="3">Three</OPTION>
<OPTION VALUE="4">Four</OPTION>
<OPTION VALUE="5">Five</OPTION>
<OPTION VALUE="6">Six</OPTION>
</SELECT>
<INPUT TYPE="button"
       NAME="btnTest"
       VALUE="Change OPTION 3 Text to Periwinkle"
       CLASS="jsvButtons"
       onClick="performTest(this.form);">
</FORM>

<SCRIPT LANGUAGE="JavaScript" TYPE="text/javascript">
function performTest(formObj) {
    JSV_setOptionText(formObj.ChangeSelect, 2, "Periwinkle");
}
</SCRIPT>

produce