Um das TreeListControl-Tag auf einer JSP Seite einzusetzen, muss am Anfang der Seite die entsprechende Tag Library deklariert werden. Anschließend können die Common-Controls mit dem Präfix <ctrl:tagname /> referenziert werden. [Zudem muss die Aufnahme der Tag Bibliotheken im Deployment-Deskriptor, der WEB-INF/web.xml Datei, erfolgen]

<%@ taglib uri="/WEB-INF/tlds/cc-controls.tld" prefix="ctrl" %>

<ctrl:treelist
    id="tl1"
    name="regions"
    action="sample301/regionBrowse"
    title="Regions Structure"
    rows="15"
    refreshButton="true"
    expandMode="multiple"
    root="true">

    <ctrl:columntree
        title="Region"
        property="region"
        width="180"
        imageProperty="type"/>

    <ctrl:columntext
        title="Name"
        property="name"
        width="250"/>

    <ctrl:columnadd
        title="Add"
        property="add"/>

    <ctrl:columnedit
        title="Edit"
        property="editable"/>

    <ctrl:columndelete
        title="Delete"
        property="editable"/>
</ctrl:treelist>

Da wir das TreeListControl in der Session abgelegt haben, wird der Name der Bean über das name-Attribut angegeben. Zudem wird über das action-Attribut die Action spezifiziert, an die Aktionen aus unserem TreeListControl (onEdit, onDelete, etc... ) delegiert werden.

Wird das TreeListControl in einer FormBean abgelegt, reicht die Angabe des property-Attributes aus. Der Scope der Formbean muss in diesem Fall auf "session" eingestellt werden, damit das Kontrollelement über Server Roundtrips hinweg seinen Zustand behalten kann.

Bei Einsatz einer Workflowsteuerung kann das Kontrollelement über andere Komponenten erzeugt und später wieder aus der Session gelöscht werden.

Damit sind alle notwendigen Schritte zur Nutzung des TreeListControls abgeschlossen. Das Auf- und Zuklappverhalten muß nicht selbst implementiert werden. Es wird durch das Kontrollelement selbst verwaltet. Zur Navigation stellt das Kontrollelement Blätterbuttons zur Verfügung, die aktiviert werden, sobald die vorgegebene Zeilenanzahl überschritten wird.

zurück   |   weiter