01: /* ComboitemRendererExt.java
02:
03: {{IS_NOTE
04: Purpose:
05:
06: Description:
07:
08: History:
09: Dec 27, 2007 11:27:33 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: * Provides additional control to {@link ComboitemRenderer}.
23: * @author jumperchen
24: *
25: */
26: public interface ComboitemRendererExt {
27: /** Creates an instance of {@link Comboitem} for rendering.
28: * The created component will be passed to {@link ComboitemRenderer#render}.
29: *
30: * <p>Note: remember to invoke {@link Comboitem#applyProperties} to initialize
31: * the properties, defined in the component definition, properly.
32: *
33: * <p>If null is returned, the default comboitem is created as follow.
34: <pre><code>
35: final Comboitem item = new Comboitem();
36: item.applyProperties();
37: return item;
38: </code></pre>
39: *
40: * <p>Note: DO NOT call {@link Comboitem#setParent}.
41: *
42: * @return the comboitem if you'd like to create it differently, or null
43: * if you want {@link Comboitem} to create it for you
44: */
45: public Comboitem newComboitem(Combobox combobox);
46: }
|