Programmer's Guide > Interfaces > TableObject interface > renameColspec method
  
renameColspec method
Renames a single colspec tag by updating the tag's colname attribute and adjusting all spanspec and entry tags to refer to the colspec tag by its the new value for the colname attribute. This is applied to the TableGrid containing the table object or all TableGrids in the TableSet or TableTilePlex as appropriate.
renameColspec(colexam, oldSpecname, newSpecname)
Parameters
unsigned shortcolexam
An ExamineWhatColspec value that specifies which columns to examine while looking for this colspec tag.
StringoldSpecname
A string specifying the colspec tag to be renamed. (That is, the colspec tag with colname=oldSpecname.)
StringnewSpecname
The new name for the colspec tag.
Returns
void
Throws
TableException
OPERATION_FAILED_ERR: Raised if the table model doesn't support this operation or if the operation fails for some other reason.