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

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

     ATTACH <cId> TO <aParent> GET <uVar> ;
                  AT <nRow>, <nCol> ;
                  [PAGE <nPage>] ;
                  [PICTUREGET <cPicGet>] ;
                  [PICTURESAY <cPicSay>] ;
                  [CONDITION <uCond>] ;
                  [ACTIVE <uActive>] ;
                  [PROMPT <cPrompt>] ;
                  [PROMPTAT <nPRow>, <nPCol>] ;
                  [DISPLAYIF <uDiIf>] ;
                  [SYSFUNCTION <uSys>] ;
                  [REFRESHGRP <uGrp>] ;
                  [COMPUTEDEXP <uCmpExp>] ;
                  [COMPUTEDGRP <uCmpGrp>] ;
                  [<Cmb|COMBO>] ;
                  [GAP <nGap>] ;
                  [MESSAGE <cMes>] ;
                  [PFK <aPfk>] ;
                  [VARNAME <cVarName>];
                  [ACT <cAct>] ;
                  [COLOR <aCol>] ;
                  [REFRESHID <cRID>]

Parameters:

     <cId>      Shows the name of the control 
     <aParent>  Item of objects form in which the controls are added 
     <uVar>     Name of the variable  
     AT <nRow>, <nCol> Coordinates of row and column where is the control
                GET 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
     PICTUREGET <cPicGet> Picture used for to format date that is inserted 
     PICTURESAY <cPicSay> Picture used for to format date that is shown 
     CONDITION <uCond> Condition of validation 
     ACTIVE <uActive> Allow to specify in which condition the control is
                active
     PROMPT <cPrompt> Messagge that is associated at control GET 
     PROMPTAT <nPRow>, <nPCol> Coordinates where is the PROMPT of the
                control GET
     DISPLAYIF <uDiIf> Conditional Display. the control in shown on the
                objects if the expression in <uDiIf> is True
     SYSFUNCTION <uSys> Function of sys. When control is active, the
                function defined in <uSys> is executed if a button is
                pushed
     REFRESHGRP <uGrp> Specifies which group of control must be updated
                when is modified the control GET
     COMPUTEDEXP <uCmpExp> Expression of evaluation for  evaluated fileds 
     COMPUTEDGRP <uCmpGrp> ID of CONTROL of type GET that must invoke the
                refresh of this CONTROL
     COMBO <Cmb> Permits to associate  icon of type COMBO at control GET 
     GAP <nGap> If at control is associated an icon of type Combo, <nGap>
                point to the space between icona and PROMPT of control
     MESSAGE <cMes> Text that will be shown in the row of messagges when
                cursor is  on the control
     PFK <aPfk> Array of buttons actives on the control 
     VARNAME <cVarName> Name of the variable for inheritance 
     ACT <cAct> String that contain other actions for to release during get
     COLOR <aCol> Array where there are attributes of color Clipper used
                for link at the control the specific color
     BEFORE <uBefore> Code Block that must be executed before GET 
     REFRESHID <cRID> Show the  groups of refresh which contain the control

Description:

     Makes a new control of type GET on the objects Form. This control is
     used for to edit the variable  fields that is parameter <uVar>.
     
     For manage this CONTROL from program is necessary to 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:

     Exempele 1 :
     
     Value of items of array if the type of  CONTROL is GET :
     
     #include "DFCTRL.CH"
     
     LOCAL aCTRL := tbCTRLArr( oWin, "GET0001" )
     
     aCTRL[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_GET_VAR       ] // Variable that is shown
     aCTRL[FORM_GET_ROW       ] // Coordinates of GET
     aCTRL[FORM_GET_COL       ] //
     aCTRL[FORM_GET_PROMPT    ] // Prompt
     aCTRL[FORM_GET_PROW      ] // Coordinates of Prompt
     aCTRL[FORM_GET_PCOL      ] //
     aCTRL[FORM_GET_PICTUREGET] // Picture of  GET
     aCTRL[FORM_GET_PICTURESAY] // Picture of SAY
     aCTRL[FORM_GET_MESSAGE   ] // Messagge related at the GET
     aCTRL[FORM_GET_PFK       ] // Array of button that are added
     aCTRL[FORM_GET_CONDITION ] // Condition related at the GET
     aCTRL[FORM_GET_ACTIVE    ] // Condition of Activation
     aCTRL[FORM_GET_CLRID     ] // Array of colors
     aCTRL[FORM_GET_COMBO     ] // Enable the COMBO at the right of the GET
     aCTRL[FORM_GET_GAP       ] // Space between  combo and GET
     
     Example 2 :
     
     #include "DFCTRL.CH"
     
     ATTACH "CodCat" TO oWin:W_CONTROL GET CodCat
       AT   2,  1                     ; // Position
       PAGE     0                     ; // Page
       COLOR {"N/GR*","G+/GR*","N/N*","W+/BG"} ; // Colors
       PROMPT     "Categori^a"        ; // Prompt
       PROMPTAT     1 ,  1            ; // Coordinatee
       PICTUREGET "XX"                ; // Picture get
       PICTURESAY "XX"                ; // Picture say
       CONDITION {|ab|CodCat(ab)}     ; // When/Valid
       SYSFUNCTION {||.T.}            ; // Function of sys
       MESSAGE "Categoria articolo"   ; // Messagge
       REFRESHID "Art"                ; // Group refresh
       COMBO                          ; // Icon combo
       ACTIVE   {||cState $ "am" }    ; // Active if
       DISPLAYIF {||.T.}                // Condition