Column"

From Documentation
m ((via JWB))
 
(20 intermediate revisions by 5 users not shown)
Line 3: Line 3:
 
= Column =
 
= Column =
  
*Demonstration: N/A
+
*Demonstration: [http://www.zkoss.org/zkdemo/grid/simple Grid (Simple Grid)]
 
*Java API: <javadoc>org.zkoss.zul.Column</javadoc>
 
*Java API: <javadoc>org.zkoss.zul.Column</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.grid.Column</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.grid.Column</javadoc>
*Style Guide: [http://books.zkoss.org/wiki/ZK_Style_Guide/XUL_Component_Specification/Column Column]
+
*Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Column|Column]]
  
 
= Employment/Purpose =
 
= Employment/Purpose =
Line 16: Line 16:
  
  
[[Image:grid.png]]
+
[[Image:ZKComRef_Grid_Example.png‎]]  
  
 
<source lang="xml" >
 
<source lang="xml" >
 
+
<window title="Grid Demo" border="normal" width="50%">
<window title="Grid Demo" border="normal" width="360px">
+
<grid>
<zscript> class Comp implements Comparator { private boolean _asc;
+
<columns sizable="true">
public Comp(boolean asc) { _asc = asc; } public int compare(Object o1,
+
<column label="Type" hflex="min"/>
Object o2) { String s1 = o1.getChildren().get(0).getValue(), s2 =
+
<column label="Content" />
o2.getChildren().get(0).getValue(); int v = s1.compareTo(s2); return
+
</columns>
_asc ? v: -v; } } Comp asc = new Comp(true), dsc = new Comp(false);
+
<rows>
</zscript>
+
<row>
<grid>
+
<label value="File:" />
<columns sizable="true">
+
<textbox width="99%" />
<column label="Type" sortAscending="&#36;{asc}"
+
</row>
sortDescending="&#36;{dsc}" />
+
<row>
<column label="Content" />
+
<label value="Type:" />
</columns>
+
<hbox>
<rows>
+
<listbox mold="select">
<row>
+
<listitem label="Java Files,(*.java)" />
<label value="File:" />
+
<listitem label="All Files,(*.*)" />
<textbox width="99%" />
+
</listbox>
</row>
+
<button label="Browse..." />
<row>
+
</hbox>
<label value="Type:" />
+
</row>
<hbox>
+
<row>
<listbox rows="1" mold="select">
+
<label value="Options:" />
<listitem label="Java Files,(*.java)" />
+
<textbox rows="3" width="99%" />
<listitem label="All Files,(*.*)" />
+
</row>
</listbox>
+
</rows>
<button label="Browse..." />
+
</grid>
</hbox>
+
</window>
</row>
 
<row>
 
<label value="Options:" />
 
<textbox rows="3" width="99%" />
 
</row>
 
</rows>
 
</grid>
 
</window>
 
 
</source>
 
</source>
  
 +
=Supported Events=
  
 
+
{| class='wikitable' | width="100%"
=Supported events=
 
 
 
{| border="1" | width="100%"
 
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
  
 
|-
 
|-
| <center><tt>onClick</tt></center>
+
| <center><code>onSort</code></center>
| <javadoc>org.zkoss.zk.ui.event.MouseEvent</javadoc>
+
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.SortEvent</javadoc>
 
+
Denotes user has sorted the row of this column.  
<tt>'''Description:''' </tt>Denotes user has clicked the component.  
 
  
 
|-
 
|-
| <center><tt>onRightClick</tt></center>
+
| <center><code>onGroup</code></center>
| <javadoc>org.zkoss.zk.ui.event.MouseEvent</javadoc>
+
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.SortEvent</javadoc>
 
+
{{ZK PE}}
<tt>'''Description:''' </tt>Denotes user has right-clicked the component.
+
Denotes user has grouped all the cells under a column.  
 
 
 
|-
 
|-
| <center><tt>onDoubleClick</tt></center>
+
| <center><code>onUngroup</code></center>
| <javadoc>org.zkoss.zk.ui.event.MouseEvent</javadoc>
+
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.SortEvent</javadoc>
 +
{{ZK EE}}
 +
{{versionSince| 6.5.0}}
 +
Denotes user has ungrouped all the cells under a column.
  
<tt>'''Description:''' </tt>Denotes user has double-clicked the component.
+
|}
  
|}
+
*Inherited Supported Events: [[ZK_Component_Reference/Base_Components/HeaderElement#Supported_Events | HeaderElement]]
  
 
=Supported Children=
 
=Supported Children=
Line 89: Line 80:
 
  *ALL
 
  *ALL
  
=Use cases=
+
=Use Cases=
  
[[ZK_Component_Reference/Data/Grid#Use_cases | Grid]]
+
[[ZK_Component_Reference/Data/Grid#Use_Cases | Grid]]
  
 
=Version History=
 
=Version History=
 +
{{LastUpdated}}
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
| &nbsp;
+
| 6.5.0
| &nbsp;
+
| June 2012
| &nbsp;
+
| [http://tracker.zkoss.org/browse/ZK-147 ZK-147]: Support ungroup for grid's column menu
 
|}
 
|}
  
 
{{ZKComponentReferencePageFooter}}
 
{{ZKComponentReferencePageFooter}}

Latest revision as of 07:40, 14 January 2022

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

ZKComRef Grid Example.png

	<window title="Grid Demo" border="normal" width="50%">
		<grid>
			<columns sizable="true">
				<column label="Type" hflex="min"/>
				<column label="Content" />
			</columns>
			<rows>
				<row>
					<label value="File:" />
					<textbox width="99%" />
				</row>
				<row>
					<label value="Type:" />
					<hbox>
						<listbox 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
  • Available for ZK:
  • http://www.zkoss.org/product/zkhttp://www.zkoss.org/whyzk/zkeeVersion pe-ee.png

Denotes user has grouped all the cells under a column.

onUngroup
Event: SortEvent
  • Available for ZK:
  • http://www.zkoss.org/product/zkhttp://www.zkoss.org/whyzk/zkeeVersion ee.png

Since 6.5.0 Denotes user has ungrouped all the cells under a column.

Supported Children

*ALL

Use Cases

Grid

Version History

Last Update : 2022/01/14


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



Last Update : 2022/01/14

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