Control : MultiColumnList

Limitations

 

Example 1: Binding to a Collection (Ex1_PersonList)

This example shows you how to bind a MultiColumnList control to a collection.

The MultiColumnList control is bound to the collection people, which is of type Person. The Person class contains the fields address, birth, firstName, and lastName. The fields are all mapped to headings on the MultiColumnList control (the field address is a complex type that is formatted as part of the column property definition).

Click for a larger image 

Example 2: Binding to a Collection (Ex2_EditPersonList)

This example shows you how to add support for editing a field within the MultiColumnList control.

Two buttons (Add New and Remove) are added to the form from Example 1. These buttons add and remove data from the underlying collection. In addition, Double Click and Remove function interfaces (Interface tab) are implemented. The Double Click function interface lets you double-click an item in the MultiColumnList control and display an editing window. The Remove function interface lets you select an item and press the Delete key to remove it from the collection.

Click for a larger image 

Example 3: Binding to a Collection (Ex3_InlineEditPersonList)

This example shows you how to enable inline editing of a field within the MultiColumnList control.

Inline editing for the Last Name and First Name columns has been added to the form from Example 1. Inline editing is enabled by setting the Edit Type property on a column (General tab, Column Settings property, on the selected column, General tab, Edit Type). For this example, Edit Type has been set to Read/Write for Last Name and First Name and Edit Type has been set to WriteOnly for Birth.

Click for a larger image 

Example 4: Embedding a Form (Ex4_Embedded_Form)

This example shows you how to embed a form within a MultiColumnList control. 

A read-only form (ReadOnly) was added to the Address class. This form is used to display the city and state information within the MultiColumnList control (the form is repeated for each record). The form is assigned under the Object Edit tab in the Edit Columns dialog box (set Object Read Only Form to the desired read-only form, and optionally, set Object Write Only Form to the desired write-only form). 

This example also demonstrates shading for alternate rows. The property is located on the StyleSheet for the the MultiColumnList control (MultiColumnListStyle). For Cell Background Type, select Alternating.

Address

This class defines the address fields (city and state) used to hold the city and state information for the addresses in all four examples. It also contains a detail form for displaying the city and state. 

Click for a larger image 

Person

This class defines the fields used to describe a person (address, birth, firstName, and lastName). It also contains a detail form for displaying the name, address, and birth date of a person.

Click for a larger image

Supported Types (Control Interface)

Type

Summary

Collection<Object>

Complex Object type fields within application objects that are connected to the MultiColumnList control where the field is a collection (the field's Is Collection property is set to true). For each item in the field’s collection, a corresponding row in the MultiColumnList is displayed by configuring the columns you want and extracting key attributes from the object’s fields to use as items in each column of the row. For example, if an object in the collection is of type Person with firstName, lastName, birth, and address fields, you can define how many columns you would like and how to extract those fields from the object when computing the text for each column of the MultiColumnList row that represents that object. If the collection changes, including the internal members of the object used in text calculation, the MultiColumnList view auto-tracks those changes and updates the MultiColumnList control on the remote client appropriately. Collections of type Object include any subclass of Object as well. For example, Collection<Person> can be tied to the MultiColumnList, where Person subclasses from Object and represents any model object in your project.

Default Interfaces

Type	Summary
MultiColumnListboxInterface	A adapter interface, assigned to the control through the Selection property

Adapters

Type	Summary
MultiColumnListboxAdapter	Enables control over the selection of items displayed in a MultiColumnListbox control. You use a MultiColumnListboxAdapter to set initial selection in the control, as well as to respond to end-user selection of items in a MultiColumnListbox.