footer text

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

Syntax

var value = obj.getFooterText(); 
obj.setFooterText(value);        

obj.onFooterTextChanging = function(value){...}; 
obj.onFooterTextChanged = function(value){...}; 
obj.onFooterTextError = function(value){...}; 

Defined in

footer model

Examples

Single footer cell

obj.setFooterText("footer text", 0); // footer text, column-0

<script> var obj = new AW.UI.Grid; obj.setColumnCount(10); obj.setFooterVisible(true); obj.setFooterText("footer text", 0); // footer text, column-0 obj.setFooterImage("favorites", 0); obj.setFooterTooltip("tooltip text", 0); document.write(obj); </script>

Complete footer row

obj.setFooterText(textArray); // footer text, array

<script> var textArray = ["Home", "Favorites", "Font size", "Search"]; var imageArray = ["home", "favorites", "fontsize", "search"]; var tooltipArray = ["home", "favorites", "fontsize", "search"]; var obj = new AW.UI.Grid; obj.setColumnCount(10); obj.setFooterVisible(true); obj.setFooterText(textArray); // footer text, array obj.setFooterImage(imageArray); obj.setFooterTooltip(tooltipArray); document.write(obj); </script>

Extended grid (multiple footer rows)

// 3 footer rows
obj.setFooterCount(3);

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

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

// single value - col 0, row 0
obj.setFooterText("** footer **", 0, 0);

<script> var obj = new AW.Grid.Extended; obj.setColumnCount(10); obj.setFooterVisible(true); // 3 footer rows obj.setFooterCount(3); // function - all columns/rows obj.setFooterText(function(col, row){return col + "." + row}); // array - row 1 obj.setFooterText(["Home", "Favorites", "Font size", "Search"], 1); // single value - col 0, row 0 obj.setFooterText("** footer **", 0, 0); document.write(obj); </script>

Remarks

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

See also

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