SMART datagrid v.1 > Classes > DataSet

DataLudi.DataSet.setRowTags  method

Specify user data which can be managed in application about each data row specified by rows. 

If specify null or undefined in rows, it will specify tag about all rows. 

If Tag of one or more rows is actually changed, GridDataSet.onTagsChanged event or TreeDataSet.onTagsChanged event will be fired. The data of any types, such as JSON object or a simple value, is possible for Tag. In addition, you can refer the specified tag in data set or several Expressions of grid and tree. 

You can get the tag which is set in each data row by getRowTag. 

Returns

Void

Parameters

rows - [Integer|TreeDataRow]. required.

tag - *. required.

Note

• In the case of specifying object as tag, it will not copy and save in DataSet. In other words, if change the properties of object after specifying as tag, the state will be maintained. If not a special case, it should be manged as a read-only object.

    // Change data tag of the selected rows.
    var rows = grid.getSelectedRows();
    if (rows && rows.length > 0) {
        var tag = _getRowTag(rows[0]);
        rows = grid.getDataIndicesOfRows(rows);
        ds.setRowTags(rows, tag);
    }

See Also

GridDataSet.onTagsChanged

TreeDataSet.onTagsChanged

setRowTag

getRowTag

unsetRowTags

TreeDataRow

Expression

DerivedField.expression

Examples

Derived Field & Row Tags

Tree Data Tag

Column Dynamic Styles

Row Dynamic Styles