RenderListBoxFromArray - Solution Sites Routine

Article
11/12/2009

This function prepares the HTML that will render a SELECT element and its subordinate OPTION elements, populating the values for the various attributes and content based on the values supplied by the parameters. It serves as a wrapper for the function RenderListBox, hardcoding the iSource parameter to the constant ARRAY_COLLECTION, and passing through all other parameters as is.

Definition

Function RenderListBoxFromArray(
  byVal sName,
  arrItemNames,
  arrItemValues,
  byVal sSelectedOption,
  byVal iSize,
  byVal bMultiple,
  byVal sAttList)

Parameters

sName
A string containing a value to be assigned to the NAME attribute.
arrItemNames
An array that contains the names of the selection choices that the user will see in the listbox, specified as content of the corresponding OPTION elements.
arrItemValues
An array that contains the values of the selection choices, used as the values assigned to the VALUE attributes of the corresponding OPTION elements.
sSelectedOption
A string that, if found to match one of the values supplied in the colItemValues parameter, results in the SELECTED attribute being present in the corresponding OPTION element.
iSize
A number containing a value to be assigned to the SIZE attribute.
bMultiple
A Boolean, which if set to True, results in the MULTIPLE attribute being present in the SELECT element.
sAttList
A string containing any additional, space-separated "attribute=value" pairs to be included in the SELECT element. This string, if non-empty, must begin with a space character.

Return Value

A string containing the HTML that will render the specified listbox.

Defined in File

include\html_lib.asp

Routines Called

RenderListBox

Called By

ShowRefinedSearch

Remarks

The pair of arrays specified by the colItemNames and colItemValues parameters must each have the same number items.

Share via