PA_GoToSelectedRecord

version 2003

PA_GoToSelectedRecord (tableNum; selRecNum)

Parameter	Type		Description
tableNum	short		Table number
selRecNum	long		Number of selected record to access

The command PA_GoToSelectedRecord moves to the record number selRecNum in the current selection of table number tableNum, and makes that record the current record. The current selection does not change.

Note that the selRecNum parameter is not the same as the number returned by PA_GetRecordNumber; it represents the record's position in the current selection. The record's position depends on how the selection is made and whether or not the selection is sorted.

If there are no records in the current selection, or the number is not in the selection, then PA_GoToSelectedRecord does nothing.

Before calling PA_GoToSelectedRecord the 4D plug-in should indicate if the many-to-one and one-to-many relations should be activated by using PA_UseAutomaticRelation.

This routine does not use virtual structure

See PA_RecordsInSelection for an example of use.

PA_RecordsInSelection, PA_SelectedRecordNumber.

Use PA_GetLastError to see if an error occurred (invalid table number).

The current selection does not change. If selRecNum is a valid number (from 1 to the number of records in the current selection), the current record becomes record number selRecNum of the selection.