vtkTable Class Reference

#include <vtkTable.h>

Inheritance diagram for vtkTable:

Inheritance graph
[legend]
Collaboration diagram for vtkTable:

Collaboration graph
[legend]

List of all members.


Detailed Description

A table, which contains similar-typed columns of data.

vtkTable is a basic data structure for storing columns of data. Internally, columns are stored in a vtkFieldData structure. However, using the vtkTable API additionally ensures that every column has the same number of entries, and provides row access (using vtkVariantArray) and single entry access (using vtkVariant).

Warning:
You should use the vtkTable API to change the table data. Performing vtkFieldData operations on the object returned by GetFieldData() may yield unexpected results. vtkTable does allow the user to set the field data using SetFieldData(); the number of rows in the table is determined by the number of tuples in the first array (it is assumed that all arrays are the same length).

Each column added with AddColumn must have its name set to a unique, non-empty string in order for GetValue() to function properly.

Thanks:
Thanks to Patricia Crossno, Ken Moreland, Andrew Wilson and Brian Wylie from Sandia National Laboratories for their help in developing this class API.
Tests:
vtkTable (Tests)

Definition at line 59 of file vtkTable.h.


Public Types

typedef vtkDataObject Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
int GetDataObjectType ()
virtual void SetFieldData (vtkFieldData *data)
vtkIdType GetNumberOfRows ()
vtkVariantArrayGetRow (vtkIdType row)
void GetRow (vtkIdType row, vtkVariantArray *values)
void SetRow (vtkIdType row, vtkVariantArray *values)
vtkIdType InsertNextBlankRow ()
vtkIdType InsertNextRow (vtkVariantArray *arr)
void RemoveRow (vtkIdType row)
vtkIdType GetNumberOfColumns ()
const char * GetColumnName (vtkIdType col)
vtkAbstractArrayGetColumnByName (const char *name)
vtkAbstractArrayGetColumn (vtkIdType col)
void AddColumn (vtkAbstractArray *arr)
void RemoveColumnByName (const char *name)
void RemoveColumn (vtkIdType col)
vtkVariant GetValue (vtkIdType row, vtkIdType col)
vtkVariant GetValueByName (vtkIdType row, const char *col)
void SetValue (vtkIdType row, vtkIdType col, vtkVariant value)
virtual void Initialize ()
virtual void ShallowCopy (vtkDataObject *src)
void SetValueByName (vtkIdType row, const char *col, vtkVariant value)

Static Public Member Functions

static vtkTableNew ()
static int IsTypeOf (const char *type)
static vtkTableSafeDownCast (vtkObject *o)
static vtkTableGetData (vtkInformation *info)
static vtkTableGetData (vtkInformationVector *v, int i=0)

Protected Member Functions

 vtkTable ()
 ~vtkTable ()

Protected Attributes

vtkVariantArrayRowArray
vtkIdType Rows

Member Typedef Documentation

Reimplemented from vtkDataObject.

Definition at line 63 of file vtkTable.h.


Constructor & Destructor Documentation

vtkTable::vtkTable (  )  [protected]

vtkTable::~vtkTable (  )  [protected]


Member Function Documentation

static vtkTable* vtkTable::New (  )  [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkDataObject.

virtual const char* vtkTable::GetClassName (  )  [virtual]

Reimplemented from vtkDataObject.

static int vtkTable::IsTypeOf ( const char *  name  )  [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkDataObject.

virtual int vtkTable::IsA ( const char *  name  )  [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkDataObject.

static vtkTable* vtkTable::SafeDownCast ( vtkObject o  )  [static]

Reimplemented from vtkDataObject.

void vtkTable::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkDataObject.

int vtkTable::GetDataObjectType (  )  [inline, virtual]

Return what type of dataset this is.

Reimplemented from vtkDataObject.

Definition at line 67 of file vtkTable.h.

virtual void vtkTable::SetFieldData ( vtkFieldData data  )  [virtual]

Sets the field data for the table.

Reimplemented from vtkDataObject.

vtkIdType vtkTable::GetNumberOfRows (  ) 

Get the number of rows in the table.

vtkVariantArray* vtkTable::GetRow ( vtkIdType  row  ) 

Get a row of the table as a vtkVariantArray which has one entry for each column. NOTE: This version of the method is NOT thread safe.

void vtkTable::GetRow ( vtkIdType  row,
vtkVariantArray values 
)

Get a row of the table as a vtkVariantArray which has one entry for each column.

void vtkTable::SetRow ( vtkIdType  row,
vtkVariantArray values 
)

Set a row of the table with a vtkVariantArray which has one entry for each column.

vtkIdType vtkTable::InsertNextBlankRow (  ) 

Insert a blank row at the end of the table.

vtkIdType vtkTable::InsertNextRow ( vtkVariantArray arr  ) 

Insert a row specified by a vtkVariantArray. The number of entries in the array should match the number of columns in the table.

void vtkTable::RemoveRow ( vtkIdType  row  ) 

Delete a row from the table. Rows below the deleted row are shifted up.

vtkIdType vtkTable::GetNumberOfColumns (  ) 

Get the number of columns in the table.

const char* vtkTable::GetColumnName ( vtkIdType  col  ) 

Get the name of a column of the table.

vtkAbstractArray* vtkTable::GetColumnByName ( const char *  name  ) 

Get a column of the table by its name.

vtkAbstractArray* vtkTable::GetColumn ( vtkIdType  col  ) 

Get a column of the table by its column index.

void vtkTable::AddColumn ( vtkAbstractArray arr  ) 

Add a column to the table.

void vtkTable::RemoveColumnByName ( const char *  name  ) 

Remove a column from the table by its name.

void vtkTable::RemoveColumn ( vtkIdType  col  ) 

Remove a column from the table by its column index.

vtkVariant vtkTable::GetValue ( vtkIdType  row,
vtkIdType  col 
)

Retrieve a value in the table by row and column index as a variant. Note that this calls GetValueByName internally so that each column array must have its name set (and that name should be unique within the table).

vtkVariant vtkTable::GetValueByName ( vtkIdType  row,
const char *  col 
)

Retrieve a value in the table by row index and column name as a variant.

void vtkTable::SetValue ( vtkIdType  row,
vtkIdType  col,
vtkVariant  value 
)

Set a value in the table by row and column index as a variant.

void vtkTable::SetValueByName ( vtkIdType  row,
const char *  col,
vtkVariant  value 
)

Set a value in the table by row index and column name as a variant.

virtual void vtkTable::Initialize (  )  [virtual]

Initialize to an empty table.

Reimplemented from vtkDataObject.

static vtkTable* vtkTable::GetData ( vtkInformation info  )  [static]

Retrieve the table from vtkInformation.

Reimplemented from vtkDataObject.

static vtkTable* vtkTable::GetData ( vtkInformationVector v,
int  i = 0 
) [static]

Retrieve the table from vtkInformation.

Reimplemented from vtkDataObject.

virtual void vtkTable::ShallowCopy ( vtkDataObject src  )  [virtual]

Shallow and Deep copy. These copy the data, but not any of the pipeline connections.

Reimplemented from vtkDataObject.


Member Data Documentation

Holds row information returned by GetRow().

Definition at line 167 of file vtkTable.h.

The number of rows in the table.

Definition at line 170 of file vtkTable.h.


The documentation for this class was generated from the following file:

Generated on Sat Dec 27 13:52:35 2008 for VTK by  doxygen 1.5.6