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

Syntax

WSMART( aArray )

Purpose

Creates a group of Tbrowse objects, much as each Tbrowse object is
comprised of TbColumn objects. Most often this is used to reflect
relationships between the files browsed (i.e. the customer browser zooms to
reveal the orders placed by the selected customer; the selected order zooms
to reveal the items placed on it).

Arguments

     aArray -- an array of arrays, each of which satisfies the requirements
               of TBROWSER(). Each subarray has the following structure:

     aArray[ 1 ] -- aDbfs: an array of file aliases corresponding to each
                    window to be opened.

     aArray[ 2 ] -- aWindows: an optional array of "column objects" to
                    present in the browse window. NIL invokes automatic
                    columns mode and all fields in the current table (up to
                    a maximum specified in AA_TBROW.CH) are used.
                    Otherwise, aWindows must be an array of arrays in which
                    each subarray contains a field expression, its header
                    or NIL for a default header, a picture, a colour
                    definition, and a colour block.

     aArray[ 3 ] -- aBlocks: an optional array which contains information
                    on keystroke processors to be associated with each
                    window. If not passed, each window uses the library
                    function TBKEYS(). If passed, each array element may
                    contain either NIL, a code block or a two-element
                    array. If the array element is NIL, TBKEYS() is
                    invoked. If it contains a code block, TBKEYS()
                    processes the movement keys and evaluates the code
                    block to handle keystroke exceptions. If the subarray
                    element contains an array consisting of a code block
                    and a logical true, the code block overrides TBKEYS()
                    completely.

    aArray[ 4 ] -- aLocks: an array of window-locking expressions. Each
                    locking expression may be either NIL, a single data
                    value (as in a parental index key), or a two-element
                    array containing low and high scope values.

     aArray[ 4 ] -- aFlags: an optional array of flags shaping the overall
                    behaviour of each window. The elements are:

     aArray[ 4, 1 ] -- a logical indicating whether to create a frozen
                       column containing the currently active index key.

     aArray[ 4, 2 ] -- a numeric indicating the number of columns to
                       freeze.

     aArray[ 4, 3 ] -- a logical indicating whether to prepend a column
                       containing the record number.

Setup

The files to be browsed must be open and selected.

Example

     < assumes CUSTOMER, ORDERS, ORD_ITEM and PRODUCT are open >

     /* this array contains the DBFs in use */
     LOCAL aDbfs   := { "CUSTOMER" , ;
                        "ORDERS" , ;
                        "ORD_ITEM", ;
                        "PRODUCT" ;
                      }
     WSMART( { aDbfs } )

Returns

NIL.

Side Effects

Crash on unopened or unselected files, or bad array contents.

Artful Calls

TBROWSER()

Source File

AA_WSMART.PRG