The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....


Home MathPack DataTable Methods RemoveUnmarkedRows
See also: RemoveRow, IfRowHasCellState, RemoveRows, RemoveMarkedRows, RemoveUnmarkedColumns 

RemoveUnmarkedRows

Unit: SDL_datatable
Class: TDataTable
Declaration: function RemoveUnmarkedRows (FirstRow, LastRow: integer; CSMask: byte): integer;

The method RemoveUnmarkedRows deletes all rows in the range from FirstRow to LastRow which do not contain any data cell whose cell state (partially) matches the parameter CSMask (i.e. a bitwise AND of the cell state and CSMask is zero). The size of the table is automatically decreased by the number of matched rows. The method RemoveUnmarkedRows triggers the OnChangeSetup event.

The function returns the number of deleted rows if everything is OK or -1 if the FirstRow or the LastRow parameter is out of range.

Hint: Setting both FirstRow and LastRow to zero values is a shortcut for setting FirstRow=1 and LastRow=NrOfRows, i.e. the entire data table is scanned for matching cells if both parameters are set to zero.


Last Update: 2023-Dec-14