footer data

Sets or retrieves the data in the grid footer row (footer data). Converted to the display text by the footer format object.

Syntax

var value = obj.getFooterData(); 
obj.setFooterData(value);        

obj.onFooterDataChanging = function(value){...}; 
obj.onFooterDataChanged = function(value){...}; 
obj.onFooterDataError = function(value){...}; 

Defined in

footer model

Examples

Encoding html control characters (<, >, ", &).

obj.setFooterVisible(true);
obj.setFooterData("<bottom text>", 0);
obj.setFooterFormat(new AW.Formats.String, 0);
obj.setFooterText(function(i){
    var data = this.getFooterData(i);
    var format = this.getFooterFormat(i);
    return format ? format.dataToText(data) : data;
});

<script> var obj = new AW.UI.Grid; obj.setColumnCount(10); obj.setFooterVisible(true); obj.setFooterData("<bottom text>", 0); obj.setFooterFormat(new AW.Formats.String, 0); obj.setFooterText(function(i){ var data = this.getFooterData(i); var format = this.getFooterFormat(i); return format ? format.dataToText(data) : data; }); document.write(obj); </script>

Applying number format

var number = new AW.Formats.Number;
number.setTextFormat("$ #,###.##");

obj.setFooterVisible(true);
obj.setFooterData("1234567.890", 0);
obj.setFooterFormat(number, 0);
obj.setFooterText(function(i){
    var data = this.getFooterData(i);
    var format = this.getFooterFormat(i);
    return format ? format.dataToText(data) : data;
});

<script> var obj = new AW.UI.Grid; obj.setColumnCount(10); var number = new AW.Formats.Number; number.setTextFormat("$ #,###.##"); obj.setFooterVisible(true); obj.setFooterData("1234567.890", 0); obj.setFooterFormat(number, 0); obj.setFooterText(function(i){ var data = this.getFooterData(i); var format = this.getFooterFormat(i); return format ? format.dataToText(data) : data; }); document.write(obj); </script>

Remarks

Should always be used together with the footer format object and converter function in the footer text property (see the examples above).

See also

Overview: using format converters
Grid templates: footer
Footer model: text, image, tooltip, link, value, format
Data properties: cell, selector, header, top, bottom