"appendLine"

Appends either a row containing values or an empty row. to the table

Synopsis

1)

setValue(string shape, "appendLine", string Name1, <type1> Value1 [, string Name2, <type2> Value2... [, 0, int rowFontType]]);

setValue (string shape, "appendLine", string Name1, <dyn_type1> Value1 [, string Name2, <dyn_type2> Value2... [, 0, int rowFontType]]);

shape.appendLine (string Name1, <type1> Value1 [, string Name2, <type2> Value2... [, 0, int rowFontType]]);

2)

setValue(stringshape, "appendLine",intDummy);

shape.appendLine (int Dummy);

Parameters

Parameter Description
shape Name of the object
Name1 Column name
Value1 Row contents to be set
rowFontType

The font type. There are 4 different font types available:

0 = Normal (default)

1 = Bold

2 = Italic

3 = Italic bold
Dummy Dummy parameter

Description

There are two function types depending on the chosen synopsis:

1. Adds a row containing the specified column values to the table whereby the column is specified by "Name" and the associated value with "Value". Color information for the row can also be passed in a three-element dynamic array instead of by a single value whereby the array contains the value plus the background and foreground color.

[<anytype> Value[<string> bCol [<string> fCol]]

Value is the value to be set, "bCol" the background color and "fCol" the foreground color for a cell. See also the "appendLines" example.

2. Adds a row with empty columns to the table. In this case the dummy parameter must be the integer value "0".

The function "appendLine" removes any previous table selection and any table sorting is ignored, that is, the cell is added to the end of the table. The parameter "rowFontType" enables the definition of a font type for the specific row.

Example

Appends a line with the values 150 and "Meter" ; in the columns "Length" ; and "Unit" , respectively.

main()
{
  shape table=getShape("Table1");
  table.appendLine("Length",150,"Unit","Meter");
}

Append an empty row:

main()
{
  shape table=getShape("Table1");
  table.appendLine(0);
}

Assignment

Table