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 RemoveMarkedColumns
See also: RemoveColumn, RemoveMarkedRows, RemoveUnmarkedColumns 

RemoveMarkedColumns

Unit: SDL_datatable
Class: TDataTable
Declaration: function RemoveMarkedColumns (FirstCol, LastCol: integer; CSMask: byte): integer;

The method RemoveMarkedColumns deletes all columns in the range from FirstCol to LastCol which contain at least one data cell whose cell state (partially) matches the parameter CSMask (i.e. a bitwise AND of the cell state and CSMask is not zero). The size of the table is automatically decreased by the number of matched columns. The method RemoveMarkedColumns triggers the OnChangeSetup event.

The function returns the number of deleted columns if everything is OK or -1 if the FirstCol or the LastCol parameter is out of range.

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


Last Update: 2023-Dec-14