WOCheckboxMatrix

Component Description

The WOCheckboxMatrix component displays a multi-column array of checkboxes based on a list of objects and allows the user to select any combination of these objects. This component displays its content (everything between the <WEBOBJECT...> and </WEBOBJECT...> tags in the template file) for each of the items in list in the same order as WOTable. This component must be embedded within a WOForm.

Synopsis

WOCheckBoxMatrix { list=anArray; item=anObject; selections=anArray; maxColumns=aNumber; };

Bindings

list: Array of objects from which the checkboxes derive their values. For example, the array could be named movieArray and contain Movie objects.

item: Identifier for the elements of the list. This attribute is updated for each iteration through list. For example, currentMovie could represent an object in movieArray.

selections: An array of objects the user chooses from the list. This attribute is updated when the user submits the form containing the WOCheckboxMatrix. For the movie example, selections array would hold Movie objects.

maxColumns: The number of columns of checkboxes displayed.