bottom data

Sets or retrieves the data in the bottom-left corner of the grid control (bottom selector data). Converted to the display text by the bottom format object.

Syntax

var value = obj.getBottomData(); 
obj.setBottomData(value);        

obj.onBottomDataChanging = function(value){...}; 
obj.onBottomDataChanged = function(value){...}; 
obj.onBottomDataError = function(value){...}; 

Defined in

bottom model

Examples

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

obj.setBottomData("<bottom text>");
obj.setBottomFormat(new AW.Formats.String);
obj.setBottomText(function(i){
    var data = this.getBottomData(i);
    var format = this.getBottomFormat(i);
    return format ? format.dataToText(data) : data;
});

<script> var obj = new AW.UI.Grid; obj.setFooterVisible(true); obj.setSelectorVisible(true); obj.setSelectorWidth(100); obj.setBottomData("<bottom text>"); obj.setBottomFormat(new AW.Formats.String); obj.setBottomText(function(i){ var data = this.getBottomData(i); var format = this.getBottomFormat(i); return format ? format.dataToText(data) : data; }); document.write(obj); </script>

Applying number format

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

obj.setBottomData("1234567.890");
obj.setBottomFormat(number);
obj.setBottomText(function(i){
    var data = this.getBottomData(i);
    var format = this.getBottomFormat(i);
    return format ? format.dataToText(data) : data;
});

<script> var obj = new AW.UI.Grid; obj.setFooterVisible(true); obj.setSelectorVisible(true); obj.setSelectorWidth(100); var number = new AW.Formats.Number; number.setTextFormat("$ #,###.##"); obj.setBottomData("1234567.890"); obj.setBottomFormat(number); obj.setBottomText(function(i){ var data = this.getBottomData(i); var format = this.getBottomFormat(i); return format ? format.dataToText(data) : data; }); document.write(obj); </script>

Remarks

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

See also

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