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

 AX_SetTagNo()
 Set a tag active by number
------------------------------------------------------------------------------

 Syntax

     AX_SetTagNo( [<nTagNo> [,<nFileOrder> | <cCDXName>]] ) -> logical

     <nTagNo> A numeric value representing the position of the tag within
     the current or specified .cdx file.

     <nFileOrder> A numeric value specifying the number of the index
     containing the tag.  The index number is based on the order in which
     the indexes are opened.

     <cCDXName>  specifies which .cdx file contains the specified tag.
     This is used to eliminate conflicts between two .cdx files with
     duplicate tag names.  Order is set to the specified .cdx and the
     specified tag is given control.

 Returns

     Returns a logical .T. if the operation was successful, else returns .F.
     If an error occurred, AX_Error() will return information on why the
     function failed.

 Description

     AX_SetTagNo() activates the specified tag of the currently active or
     specified .cdx index.  If <cCDXName> or <nOrder> is specified, then
     only that index file is searched for the specified tag.  Otherwise,
     only the currently active index is searched.

     If the specified tag exists, the order is set to the .cdx file, and
     control is given to the specified tag.

     If <nTagNo> is not specified, the currently selected tag remains
     selected.  If <nTagNo> is zero (0), the index order is set to zero
     (record number order).

     If only <nTagNo> is specified and there is not active index, the
     structural .cdx is searched for the tag number.

 Example

     USE test VIA "DBFCDXAX"       // Open TEST.DBF and TEST.CDX
     AX_SetTagNo( 2 )              // Select the second tag
     ? AX_TagNo()                  // Returns 2