TableSetNameΒΆ

TableSetName sets the cell name.

bool = TableSetName(hTable, smName)
bool = TableSetName(hTable, smName, rvRowCol)
bool = TableSetName(hTable, smName, rvSel)

Return Value

If the function succeeds, the return value bool is TRUE (1); otherwise it is FALSE (0).

Parameters

hTable

Identifies the table object.

smName is a string matrix. If the functions was invoked with two parameters the number of columns and rows must match the number of columns and rows of the table.

If the function is invoked with three parameters the number of columns and rows must match with the selection specified by the parameter rvSel.

rvSel

rvSel is a vector with four elements specifying a range of rows and columns:

Element

Description

rvSel[1]

Left column of selection

rvSel[2]

Top row of selection

rvSel[3]

Right column of selection

rvSel[4]

Bottom row of selection

The column and row numbering starts with 1. Left is smaller than right and top is smaller than bottom.

rvRowCol

rvRowCol is a vector with two elements. If the function is invoked with three parameters and the third parameter contains two elements only, one cell name will be set. The elements have the folloing meaning:

Element

Description

rvRowCol[1]

Row number

rvRowCol[2]

Column number

id-283041