Combobox Renderer"

From Documentation
m ((via JWB))
m (replace tt with code (via JWB))
Line 1: Line 1:
 
{{ZKDevelopersReferencePageHeader}}
 
{{ZKDevelopersReferencePageHeader}}
  
When a combobox (<javadoc>org.zkoss.zul.Combobox</javadoc>) is assigned with a model, a default renderer is assigned too<ref>For the concept about component, model and renderer, please refer to [[ZK_Developer's_Reference/MVC/Model/List_Model#Model-driven_Display|the Model-driven Display section]].</ref>. The default renderer will assume that the combobox displays the data as a string<ref>If the tree is assigned a template called <tt>model</tt>, then the template will be used to render the tree. For more information, please refer to [[ZK Developer's Reference/MVC/View/Template/Tree Template|the Tree Template section]].</ref>. If you want to display more sophisticated information or retrieve a particular field of the data, you have to implement <javadoc type="interface">org.zkoss.zul.ComboitemRenderer</javadoc> to handle the rendering.
+
When a combobox (<javadoc>org.zkoss.zul.Combobox</javadoc>) is assigned with a model, a default renderer is assigned too<ref>For the concept about component, model and renderer, please refer to [[ZK_Developer's_Reference/MVC/Model/List_Model#Model-driven_Display|the Model-driven Display section]].</ref>. The default renderer will assume that the combobox displays the data as a string<ref>If the tree is assigned a template called <code>model</code>, then the template will be used to render the tree. For more information, please refer to [[ZK Developer's Reference/MVC/View/Template/Tree Template|the Tree Template section]].</ref>. If you want to display more sophisticated information or retrieve a particular field of the data, you have to implement <javadoc type="interface">org.zkoss.zul.ComboitemRenderer</javadoc> to handle the rendering.
  
 
For example,
 
For example,

Revision as of 14:12, 12 January 2022



When a combobox (Combobox) is assigned with a model, a default renderer is assigned too[1]. The default renderer will assume that the combobox displays the data as a string[2]. If you want to display more sophisticated information or retrieve a particular field of the data, you have to implement ComboitemRenderer to handle the rendering.

For example,

public class MyRenderer implements ComboitemRenderer {
	public void render(Comboitem item, Object data, int index) throws Exception {
		item.setLabel(((User)data).getName());
		item.setDescription(((User)data).getDescription());
	}
}

  1. For the concept about component, model and renderer, please refer to the Model-driven Display section.
  2. If the tree is assigned a template called model, then the template will be used to render the tree. For more information, please refer to the Tree Template section.

Version History

Last Update : 2022/01/12


Version Date Content
6.0.0 February 2012 The index argument was introduced.



Last Update : 2022/01/12

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.