ZK Component Reference/Data/Grid/Column

Column

• Demonstration: Grid (Simple Grid)
• Java API: Column
• JavaScript API: Column
• Style Guide: Column

Employment/Purpose

A single column in a Columns element. Each child of the Column element is placed in each successive cell of the grid. The column with the most child elements determines the number of rows in each column. The use of column is mainly to define attributes for each cell in the grid.

Example

<window title="Grid Demo" border="normal" width="360px">
	<zscript> class Comp implements Comparator { private boolean _asc;
		public Comp(boolean asc) { _asc = asc; } public int compare(Object o1,
		Object o2) { String s1 = o1.getChildren().get(0).getValue(), s2 =
		o2.getChildren().get(0).getValue(); int v = s1.compareTo(s2); return
		_asc ? v: -v; } } Comp asc = new Comp(true), dsc = new Comp(false);
	</zscript>
	<grid>
		<columns sizable="true">
			<column label="Type" sortAscending="&#36;{asc}"
				sortDescending="&#36;{dsc}"  width="50px"/>
			<column label="Content" />
		</columns>
		<rows>
			<row>
				<label value="File:" />
				<textbox width="99%" />
			</row>
			<row>
				<label value="Type:" />
				<hbox>
					<listbox rows="1" mold="select">
						<listitem label="Java Files,(*.java)" />
						<listitem label="All Files,(*.*)" />
					</listbox>
					<button label="Browse..." />
				</hbox>
			</row>
			<row>
				<label value="Options:" />
				<textbox rows="3" width="99%" />
			</row>
		</rows>
	</grid>
</window>

Supported Events

Name	Event Type
onSort	Event: SortEvent Denotes user has sorted the row of this column.
onGroup	Event: SortEvent [ZK PE] Denotes user has grouped all the cells under a column.
onUngroup	Event: SortEvent [ZK EE] [Since 6.1.0] Denotes user has ungrouped all the cells under a column.

• Inherited Supported Events: HeaderElement

Supported Children

*ALL

Use Cases

Grid

Version History

Version	Date	Content
6.1.0	June 2012	ZK-147: Support ungroup for grid's column menu