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

ATTACH ... SAY                                                  DFCTRL.CH   
Makes a new control of type SAY
------------------------------------------------------------------------------
Syntax:

     ATTACH <cId> TO <aParent> SAY <uVar> ;
                  AT <nRow>, <nCol> ;
                  [PAGE <nPage>] ;
                  [COLOR <aCol>] ;
                  [DISPLAYIF <uDiIf>] ;
                  [REFRESHID <cRID>]

Parameters:

     <cId>      Shows the name of the control 
     <aParent>  Item of objects form in which the controls are added 
     <uVar>     Name of variable 
     AT <nRow>, <nCol> Coordinates of row and column where the control SAY
                is on the objects Coordinates are of the objects
     PAGE <nPage> Number of page where is the control If nPage = 0 the
                control is available on all pages of management
     COLOR <aCol> Array where there are attributes of color Clipper used
                for link at the control the specific color
     DISPLAYIF <uDiIf> Conditional Display. the control in shown on the
                objects if the expression in <uDiIf> is True
     REFRESHID <cRID> Show the  groups of refresh which contain the control

Description:

     Makes new control SAY on the object Form. This control is used only
     for show data give as parameters <uVar>.
     
     For enter at this CONTROL from program is necessary use the function
     tbCTRLArr(). This function will give the array that forms the CONTROL.
     With modification of this array is possible change during RUN-TIME
     characteristic of the CONTROL.

Example:

     Example1 :
     
     Value of items of the array when the CONTROL
     is SAY ':
     
     #include "DFCTRL.CH"
     
     LOCAL aCTRL := tbCTRLArr( oWin, "SAY0001" )
     
     [FORM_CTRL_TYP      ] // Type CONTROL
     aCTRL[FORM_CTRL_ID       ] // ID of control
     aCTRL[FORM_CTRL_RID      ] // Refresh ID of CONTROL
     aCTRL[FORM_CTRL_PAGE     ] // Page of CONTROL
     aCTRL[FORM_CTRL_STABLE   ] // Flag for stable fhe CONTROL
     aCTRL[FORM_CTRL_DISPLAYIF] // CodeBlock of "Showing only if .."
     
     aCTRL[FORM_SAY_VAR  ] // Valor of which to make the SAY
     aCTRL[FORM_SAY_ROW  ] // Row for show
     aCTRL[FORM_SAY_COL  ] // Column for show
     aCTRL[FORM_SAY_CLRID] // Array of colors
     
     Example 2 :
     
     #include "DFCTRL.CH"
     
     // Source
     
     ATTACH "say0018" TO oWin:W_CONTROL SAY "Page N."
            AT  17, 50          ; //
            PAGE      0         ; // Page
            COLOR    {"N/G"}    ; // Array of colors
            DISPLAYIF {||.T.}     // Conditional Display