str-var = Get_Trk_Pos$(index-number)

Operands:

index-number

The index-number indicates which Track position is desired, where: (1) indicates the latest, (2) indicates the prior entry, (3) the next previous, etc.   If the index number is not specified, the default is (1).

Returns:

The answer returned is a simple comma delimited String of the format  

TOS-Line,Csr_LPtr,CSR_Coll 


Where:        

TOS-Line        The Lptr of the Top-of-Screen line in character format.


Csr_LPtr        The Lptr of the line containing the cursor in character format. If this value is zero, it indicates the cursor was on the command line.


Csr_Col        The location of the cursor within the text line in character format. If zero it indicates the cursor was in the Line-number area.


Before using this macro, be sure you have reviewed the full description in "Tracking Screen Positions" 


The Return-code should be checked before using the return value, since errors are possible. Currently the two error conditions are:

  • The index-number references a Stack entry which has never been used.
  • The Stack entry has been used, but now references a Top-of-Screen line which no longer exists (i.e. it has been deleted)