Web Connection User's Guide
Use the Multiple Select List part to add a control that allows the user to
select one or more items from a displayed list of choices. You can
define the number of items that the user can select. The HTML Multiple
Select List part generates the HTML element select with
the multiple attribute. Items within the list are
represented by option elements.
To add a Multiple Select List part, select the Web Form Parts Category (
), then the Multiple Select List part (
). You can also add the part using the Add Part dialog and specifying
the class name, AbtHtmlMultipleSelectList.
The Multiple Select List part has the following properties:
- attributeName
- Use the attributeName property to specify which attribute of
the objects in the collection should be displayed in the part.
- converter
- Use the converter property to specify the converter to use for
the part. A converter is an object that manages the conversion of other
objects to and from their display format for certain visual parts, such as a
Text part.
- eventHandlers
- Use the eventHandlers property to define any event handlers for
this part. Event handlers provide the ability to detect and react to
events that occur while an HtmlPage is loaded in a Web browser. An
example of an event handler is mouse over, where you can specify
when the mouse moves over an HTML element, something happens, usually a
JavaScript is executed..
- extraAttributes
- Use the extraAttributes property to specify any additional HTML
attributes that you want included in the HTML tagging generated by the
part. You can use this property to include HTML attributes that are not
directly supported by VisualAge.
- items
- Use the items to specify the initial items you want displayed
by the part when it appears.
- partName
- In the Part name field, type the name you want to use to
describe the part. For non-visual parts, this text appears under the
icon for the part on the free-form surface.
The name of the part can consist of alphanumeric characters, and must be
unique from all other parts on the layout surface.
This field is optional. If you do not specify a part name, VisualAge
generates a unique name based on the class name of the part.
- selectedItems
- Use the selectedItems property to specify the items that appear
selected in a multiple selection part when the part is rendered in a Web
browser.
- selectionIndices
- Use the selectionIndices property to specify the indices of the
items you want initially selected when the Multiple Select List part first
appears.
- visibleItemCount
- Use the visibleItemCount property to specify the number of
items you want to be visible in the part at any one time. This property
determines the height of the list on the page.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]