PA_GotoRecord


version 2003


PA_GotoRecord (tableNum; recordNum)

Parameter Type Description
tableNum short Table number
recordNum long Record number

Description

The command PA_GotoRecord reduces the selection of the table number tableNum to the record whose physical record number is specified by recordNum . After executing this routine, the record is the only record in the selection.

To obtain the physical record number of a current record, use PA_GetRecordNumber .

Note that calling PA_GotoRecord is the fastest way to access a record.

Example

Reducing the selection to the current record.

   short DoRecordSelection (short tableNum)
   {
      long   recordNum;
      recordNum = PA_RecordNumber(tableNum);
      if(PA_GetLastError() == eER_NoErr)
         PA_GotoRecord(tableNum, recordNum);
 
      return PA_GetLastError();
   }

See Also

PA_RecordNumber .

Error Handling

Use PA_GetLastError to see if an error occurred

Current Selections and Records

The record number recordNum becomes the current and only record in the selection.