[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 DBSCOPEINFO
 References to all CA-Clipper Xbase-style scope clause expressions
------------------------------------------------------------------------------
 Structure

     typedef struct
     {
        ITEM itmCobFor;
        ITEM lpstrFor;
        ITEM itmCobWhile;
        ITEM lpstrWhile;
        ITEM lNext;
        ITEM itmRecID;
        ITEM fRest;

        BOOL fIgnoreFilter;
        BOOL fIncludeDeleted;
        BOOL fLast;
        BOOL fIgnoreDuplicates;
     } DBSCOPEINFO;
     
     typedef DBSCOPEINFO far * LPDBSCOPEINFO;

 Elements

     itmCobFor / lpstrFor

        Contain a code block and a character expression, respectively,
        representing the conditional FOR clause.  FOR expressions are,
        essentially, filters that hide rows (records) which evaluate
        to FALSE.  The character value is provided for storage, while the
        code block is provided as a parameter for the evalBlock() method.

     itmCobWhile / lpstrWhile

        Contain a code block and a character expression, respectively,
        representing the conditional WHILE clause.  WHILE clauses permit
        continuation of a process that steps through rows until its
        expression evaluates to FALSE.  The character value is provided for
        storage, while the code block is provided as a parameter for the
        evalBlock() method.

     lNext

        Contains a numeric value representing the CA-Clipper-level NEXT lNext
        scoping clause.  This permits continuation of a process for the NEXT
        lNext rows, while obeying FOR and WHILE clauses.

     itmRecID

        Contains a numeric value representing the CA-Clipper-level RECORD
        itmRecID scoping clause.  This permits continuation of a process for
        a single record, while obeying FOR and WHILE clauses.

     fRest

        Contains a CA-Clipper-level boolean value that is set to TRUE if a
        process should continue stepping through data from the current
        work area cursor position until logical end of file.

     fIgnoreFilter

        Contains a CA-Clipper-level boolean value that is set to TRUE if a
        process should ignore any filter condition imposed on the current
        work area.

     fIncludeDeleted

        Contains a CA-Clipper-level boolean value that is set to TRUE if a
        process should include deleted rows.

     fLast

        Contains a CA-Clipper-level boolean value that is set to TRUE if the
        last record of the current scope is required.

     fIgnoreDuplicates

        Contains a CA-Clipper-level boolean value that is set to TRUE if a
        process should ignore duplicate key values.

     Warning!  You should perform code block evaluations with great
     caution.  Save any states that are likely to change as a result of
     re-entrance, so you can restore them after the code evaluation.

 Files  Header file is Rdd.api.

 Used By    AREA, DBEVALINFO, DBTRANSINFO, setLocate()


See Also: AREA DBEVALINFO DBTRANSINFO setLocate()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson