GetVectorSize Method (TableColCollection)

In This Topic

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).

Syntax

Visual Basic
C#

'Declaration
 
Public Function GetVectorSize( _
   ByVal index As Integer _
) As LengthBase

public LengthBase GetVectorSize( 
   int index
)

Parameters

index: The 0-based index (Ordinal) of the row or column.

Return Value

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();

Reference

TableColCollection Class
TableColCollection Members