:: Home >>

header text

Sets or retrieves the text in the grid column headers (header text). Does not encode the html controls characters (<, >, ", &) - the text containing correct html markup will be displayed as html.

Syntax

var value = obj.getHeaderText(); 
obj.setHeaderText(value);        

obj.onHeaderTextChanging = function(value){...}; 
obj.onHeaderTextChanged = function(value){...}; 
obj.onHeaderTextError = function(value){...}; 

Defined in

header model

Examples

Single header cell

obj.setHeaderText("header text", 0); // header text, column-0

Complete header row

obj.setHeaderText(textArray); // header text, array

Extended grid (multiple header rows)

// 3 header rows
obj.setHeaderCount(3);

// function - all columns/rows
obj.setHeaderText(function(col, row){return col + "." + row});

// array - row 1
obj.setHeaderText(["Home", "Favorites", "Font size", "Search"], 1);

// single value - col 0, row 0
obj.setHeaderText("** header **", 0, 0);

Remarks

When some of the html controls characters (<, >, ", &) should appear as text - convert them into html entity codes (&lt;, &gt;, &quot;, &amp;).

See also

Grid templates: header
Header model: image, tooltip, link, value, data, format
Text properties: cell, selector, footer, top, bottom

Comments

No comments yet.
Comments will appear on this page and in the main forum.

Documentation:

Recent changes:

2.6.4
2.6.3
2.6.2
2.6.1
2.6.1
2.6.0
2.5.0 - 2.5.6
2.5.6
2.5.0 - 2.5.5
2.5.5