Click above to get retro games delivered to your door ever month!

cmxKeyGoto()          Goto the specified key number
------------------------------------------------------------------------------

Synopsis

    cmxKeyGoto(nKeyNo) -> NIL

Arguments

    nKeyNo is the number of the key to go to.

Returns

    NIL.

Description

    cmxKeyGoto() is the complement to cmxKeyNo().  cmxKeyNo() returns the
    logical record number of the current record.  cmxKeyGoto() moves to the
    given logical record number.

    This is useful when displaying scroll bars.  If the user clicks on a
    certain position on the scroll bar, you can move to the corresponding
    record by calling cmxKeyGoto().

    cmxKeyGoto() obeys the current index scope in effect (if any).
    cmxKeyGoto(1) will go the first key in the scope, etc.

Example

    use demo                        && Assume demo has 1000 records
    set index to first              && Make records in first name order
    cmxKeyGoto(100)                 && Goto the 100'th logical record
    ? recno()                       && Who knows?
    ? cmxKeyNo()                    && Will return 100

See Also

    cmxKeyCount(), cmxKeyNo(), cmxKeySkip()