SetQuickScan (enable QuickScan on a file and any related files)

Top  Previous  Next

 

SetQuickScan( on [,propagate] ), VIRTUAL

SetQuickScan

Enables or disables quick scanning on this object's primary file and on the propagated related files.

on

A numeric constant, variable, EQUATE, or expression that enables or disables quick scanning. A value of zero (0) disables quick scanning; a value of one (1) enables quick scanning.

propagate

A numeric constant, variable, EQUATE, or expression that indicates which related files to include. Valid propogation options are none, one:many, many:one, and all. If omitted, propagate defaults to none.

The SetQuickScan method enables or disables quick scanning on this object's primary file and on the propagated related files.

Implementation:

The SetQuickScan method SENDs the QUICKSCAN driver string to the file driver for each specified file. The QUICKSCAN driver string is supported by the ASCII, BASIC, and DOS drivers. See Database Drivers for more information.

Corresponding EQUATEs for the valid propagate options are declared in FILE.INC as follows:

   ITEMIZE(0),PRE(Propagate)

None    EQUATE       !do primary file only, no related files

OneMany EQUATE       !do 1-Many relations only

ManyOne EQUATE       !do Many-1 relations only

All     EQUATE       !do all related files

   END

 

Example:

Relate:Customer.SetQuickScan(1,Propagate:OneMany) !enable quickscan for 1:Many

Relate:Orders.SetQuickScan(1)                     !enable quickscan for primary

Relate:Orders.SetQuickScan(0)                     !disable quickscan for primary