Employment/Purpose

Used to define a collection of auxiliary headers (Auxheader).

Common Use Cases

  • Merged column headers in grids and listboxes — Place one or more <auxhead> rows above <columns> to create grouped, multi-row header bands (e.g. quarterly sub-totals under a year header) using the colspan and rowspan attributes on each <auxheader>.
  • Multi-level header hierarchies — Stack several <auxhead> elements to express three or more tiers of column groupings, keeping the primary <columns> row as the leaf level.
  • Descriptive category labels — Add a single <auxhead> with wide-spanning <auxheader> cells to display a human-readable category title above a related column group without altering the sortable <column> definitions beneath it.

Example

Auxheader

<grid>
    <auxhead>
        <auxheader label="H1'07" colspan="6" />
        <auxheader label="H2'07" colspan="6" />
    </auxhead>
    <auxhead>
        <auxheader label="Q1" colspan="3" />
        <auxheader label="Q2" colspan="3" />
        <auxheader label="Q3" colspan="3" />
        <auxheader label="Q4" colspan="3" />
    </auxhead>
    <columns>
        <column label="Jan" />
        <column label="Feb" />
        <column label="Mar" />
        <column label="Apr" />
        <column label="May" />
        <column label="Jun" />
        <column label="Jul" />
        <column label="Aug" />
        <column label="Sep" />
        <column label="Oct" />
        <column label="Nov" />
        <column label="Dec" />
    </columns>
    <rows>
        <row>
            <label value="1,000" />
            <label value="1,100" />
            <label value="1,200" />
            <label value="1,300" />
            <label value="1,400" />
            <label value="1,500" />
            <label value="1,600" />
            <label value="1,700" />
            <label value="1,800" />
            <label value="1,900" />
            <label value="2,000" />
            <label value="2,100" />
        </row>
    </rows>
</grid>

Supported Events

Supported Children

* Auxheader