positionCollection

positionCollection(obj: Object;
                   row: Integer) updating;

The positionCollection method of the JadeTableSheet class positions the collection attached to the Table control to an object in that collection and to a row within the table. Use the obj parameter to specify the object to be positioned and the row parameter to specify the visible row in which to position that object.

You can use this method to scroll through an existing collection display by specifying the new position of an object within the current display. For example, the following code fragment scrolls the current collection view so that the second item is positioned in the top row (if the value of the fixedRows property is 0).

table1.accessSheet(2).positionCollection(table1.itemObject[2], 1);

When using the positionCollection method:

• The specified row may not be the resulting displayed row if the required table cannot display sufficient entries to fill the Table control.

• The row property is set to the row of the object.

• If the specified object is not a visible member of the collection in the table, the display starts from the first visible collection entry.

• If the specified row is:

  • Less than fixedRows + 1, fixedRows + 1 is assumed.

  • Greater than the number of rows in a table, the number of visible rows is assumed.