Dynamic list Java methods

These Java methods are in the class com.ibm.commerce.tools.common.ui.taglibs.com and should be used to create your dynamic list.

"/wcs/javascript/tools/common/dynamiclist.js" has to be included in your JSP page to make these Java methods function properly.

Java Method Description
public static void addControlPanel(String xmlfile, int totalpage, int totalitem, Locale loc)Deprecated

This method is deprecated and is listed here for reference only. See the following equivalent JavaScript function: parent.set_t_page_item(totalitem,listsize);

Adds the control panel to the scroll control frame. The following parameters are supported:

xmlfile

A required string parameter which is an XML file that defines the page.

totalpage

A required integer parameter corresponding to the total number of pages for the list.

totalitem

A required integer parameter corresponding to the total number of entries in the list.

loc

A required locale parameter corresponding to the national language in which the page is displayed.

Throws: ECSystemException

public static void startDlistTable(String tableid) This method begins the table definition. It is equivalent to the following HTML code: 
<table style='...' id='tableid'>

The following parameter is supported:

tableid

A required string parameter specifying the ID for the table.

Throws: ECSystemException

public static void endDlistTable() This method ends the table definition. It is equivalent to the following HTML code: 
</table>
public static void startDlistRowHeading() This method begins a heading row definition. It is equivalent to the following HTML code: 
<tr style='... '>
public static void endDlistRowHeading() This method ends a heading row definition. It is equivalent to the following HTML code: 
</tr>
public static void addDlistColumnHeading(String hvalue, String svalue, boolean role, String width, Boolean wrap) This method inserts a column into a row. The following parameters are supported:

hvalue

A required string parameter which specifies a heading name for this column. The value should be a key in a resource bundle file.

svalue

A required string parameter that specifies the value sent back to your data bean for sorting purposes. If you do not intend to make the column sortable, set this to null.

role

A required Boolean parameter that determines if this column requires sorting. If no sorting is required, set this value to false.

width

An optional string parameter which specifies the width of this column, represented by a percentage. If this is not required, set this value to null.

wrap (opt)

An optional Boolean parameter which determines whether the text in this column should wrap.

Throws: ECSystemException

public static void addDlistCheckHeading(Boolean check, String checkfnc) This method adds a Select All or Deselect All check box. The following parameters are supported:

check

A required Boolean parameter which determines whether the Select All check box is included.

checkfnc

An optional string parameter which sets a user defined function. The default value is null.
public static void endDlistRow() End row definition, equivalent to HTML code: 
</TR>
public static void startDlistRow(int row) This method begins a row definition. The following parameters are supported:

row

A required integer parameter which determines the row style. This parameter accepts the following values, 1 (color 1) or 2 (color 2). These should be alternated to improve table readability. These colors are specified in a cascading style sheet specified in the panel's JSP page.
public static void addDlistCheck(String name, String fnc, String value) This method adds a check box column so that list entries are selectable. The following parameters are supported:

name

A required string parameter, which specifies a name for the check box. This name should be unique.

fnc

A required string parameter that specifies a user defined function for this check box. If no function is defined, set this to none.

value

An optional string parameter that specifies a value for the check box. The default value is null.

Throws: ECSystemException

public static void addDlistColumn(String name, String link) This method adds a column cell. The following parameters are supported:

name

A required string parameter which specifies content for this column cell.

link (opt)

An optional string parameter which specifies a URL link for this column cell. If no link is applicable, set this to none.

Throws: ECSystemException

Related concepts

Related tasks

Related reference