xHarbour Reference Documentation > Function Reference

OrdSetRelation()

Defines a scoped relation between child work area and parent work area.

Syntax

OrdSetRelation( <nArea> | <cAlias>, ;
                <bRelation>       , ;
               [<cRelation>]        )  --> NIL

Arguments

<nArea>

The numeric ordinal position of the child work area to relate to the current work area.

<cAlias>

Optionally, the child work area can be specified as a character string holding the symbolic alias name of the child work area.

<bRelation>

A code block containing the relation expression.

<cRelation>

The relation expression in form of a character string.

Return

The function always returns NIL.

Description

The function OrdSetRelation() creates a relation between the current work area (parent) and a secondary work area (Child) specified with <nArea> or <cAlias>. The relation is scoped in the child work area, i.e. when the child area is selected as the current work area, only those records matching the <bRelation> expression can be navigated to. All other records are not visible.

OrdSetRelation() is identical with DbSetRelation() when the fourth parameter <lScoped> of this function is set to .T. (true). Refer to DbSetRelation() for more information on creating links between parent and child work areas.

Info

See also:	DbSetRelation()
Category:	Database functions , Index functions
Source:	rdd\dbcmd.c
LIB:	xhb.lib
DLL:	xhbdll.dll