Start change List tag

The following is the basic syntax of the list tag :

<LIST name=name selection="single" | "single interval" | "multi-interval">

where name identifies the list box programmatically.

The list tag can be expanded with the following elements:
<LIST name=name>
	<LOCATION>location</LOCATION>
	<SIZE>size</SIZE>
	<DATACLASS>class_name</DATACLASS>
	<ATTRIBUTE>attribute_name</ATTRIBUTE>
	<ITEM></ITEM>
	<SELECTED>selected</SELECTED>
	<DESELECTED>deselected</DESELECTED>
	<DOUBLECLICK>class_name</DOUBLECLICK>
	<FLYOVER>helptext</FLYOVER>
	<HELPALIAS>component_name</HELPALIAS>
</LIST>
	
ATTRIBUTEVALUEDESCRIPTION
<LOCATION> location Expresses the x- and y-coordinates of the list box's location from the top left corner in logical units.

This tag is required.

<SIZE> size Expresses the width and height, respectively, of the component in logical units.

This tag is required.

<DATACLASS> class_name Supplies the data for the list box.
<ATTRIBUTE> attribute_name Supplies the data for the list box. If the dataclass tag is used, the attribute tag must be used.

GETTOR PROTOCOLS:
ItemDescriptor[] get<attribute_name>List()
where the return value is an array of ItemDescriptors, each of which describes an item in the list. If the item tag defines the listbox elements statically, the gettor is not necessary.
String[] get<attribute_name>()Selection
where the return value is an array of names which identify the list items that should be selected. If not implemented, no list items will be selected when the list is displayed.


SETTOR PROTOCOLS:
void set<attribute_name>List(ItemDescriptor[] values)
where values is an array of ItemDescriptor's, each of which describes an item in the list.
void set<attribute_name>(String[] items)Selection
where items is an array of names which identify the list items selected by the user.
<ITEM> See the item tag.
<SELECTED> See the selected tag.
<DESELECTED> See the deselected tag.
<DOUBLECLICK> class_name Notifies the DoubleClickListener class when the user double-clicks on an entry in the list.
<FLYOVER> helptext Should be displayed when context help is requested for this component.

The helptext defines the key for loading the text string from the resource bundle. If the string is not found, the helptext string will appear as it does in the Panel Definition Markup Language (PDML) source file.

<HELPALIAS> component_name Should be displayed when context help is requested for this component.
End change


[ Legal | AS/400 Glossary ]