Combobox Renderer"

From Documentation
m ((via JWB))
m ((via JWB))
 
(One intermediate revision by the same user not shown)
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,
Line 20: Line 20:
  
 
=Version History=
 
=Version History=
{{LastUpdated}}
+
 
 
{| class='wikitable' | width="100%"
 
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content

Latest revision as of 07:34, 8 July 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

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



Last Update : 2022/07/08

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