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="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: org.zkoss.zk.ui.event.SortEvent Denotes user has sorted the row of this column. | | onGroup | Event: org.zkoss.zk.ui.event.SortEvent

CE
PE

Denotes user has grouped all the cells under a column. | | onUngroup | Event: org.zkoss.zk.ui.event.SortEvent

CE
PE

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

Supported Children

*ALL

Use Cases

Grid

Version History

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