01: /* ListSubModel.java
02:
03: {{IS_NOTE
04: Purpose:
05:
06: Description:
07:
08: History:
09: Jan 2, 2008 11:28:13 AM , Created by jumperchen
10: }}IS_NOTE
11:
12: Copyright (C) 2007 Potix Corporation. All Rights Reserved.
13:
14: {{IS_RIGHT
15: This program is distributed under GPL Version 2.0 in the hope that
16: it will be useful, but WITHOUT ANY WARRANTY.
17: }}IS_RIGHT
18: */
19: package org.zkoss.zul;
20:
21: /**
22: * An extra interface that can be implemented with {@link ListModel} to control
23: * the extract of the combobox.
24: *
25: * @author jumperchen
26: * @since 3.0.2
27: */
28: public interface ListSubModel {
29:
30: /** Returns the subset of list model data that the subset data is extract
31: * from combobox's list model data. It is ususally used for implmentation of
32: * auto-complete.
33: *
34: * @param value the object is used to find that the content is consistent
35: * within list model data.
36: * @param nRows the number of rows suggested to return (as the
37: * returned ListModel instance). It's a suggestion for developer to
38: * follow.
39: * If nonpositive, it means the maximal allowed rows is decided by the
40: * implementation of ListSubmodel.
41: * @since 3.0.2
42: */
43: public ListModel getSubModel(Object value, int nRows);
44: }
|