C1.C1Preview.TableVectorCollection.GetVectorSize

GetVectorSize Method

GetVectorSize(int)

Returns the size (height for rows, width for columns) of a TableVector (row or column) identified by its index in a RenderTable. This method does not create the specified vector if it has not been initialized (see remarks for details).

Declaration

public LengthBase GetVectorSize(int index)

Parameters

Type	Name	Description
int	index	The 0-based index (Ordinal) of the row or column.

Returns

Type	Description
LengthBase	The height or width of the row or column.

Remarks

Because elements of a RenderTable's collections (cells, rows and columns) are physically created "on demand" only when they are accessed via collections' indexer properties, using this method is more efficient when you only need to test the height/width of a row/column without creating it.

For instance, the following code physically creates a TableRow object before testing its height:

RenderTable rt = new RenderTable();
if (rt.Rows[10].Height == Unit.Auto)
  doSomething();

At the same time, the following code does not cause a physical row object to be created, while being functionally identical to the code above:

RenderTable rt = new RenderTable();
if (rt.Rows.GetVectorSize(10) == Unit.Auto)
  doSomething();