Navigation: ABC Library Reference > RelationManager > RelationManager Methods >====== SetQuickScan (enable QuickScan on a file and any related files)  ====== |    |
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