CT_GETFLDVAR

 GETFLDVAR()
 Determines the name of a GET field
------------------------------------------------------------------------------
 Syntax

     GETFLDVAR([<nField>]) --> cField

 Argument

     <nField>  Designates for which number of the GET field to determine
     the name of the accompanying variable.  The default is the currently
     active field.

 Returns

     GETFLDVAR() returns the name for the first position of the currently
     active or specified field.  If there is an invalid parameter, a value of
     -1 is returned.

 Description

     GET FIELD VARIABLE
     This function determines the name of an input field.  If the <nField>
     parameter is not specified, the function returns the name for the
     currently active field.  With an invalid field number or if there is on
     active field, a value of -1 is returned

 Examples

     .  Display the name of the variable associated with the second
        posted GET:

        @ 10, 10 GET VAR1
        @ 10, 20 GET VAR2
        @ 10, 30 GET VAR3

        ? GETFLDVAR(2)               //  "VAR2"

     .  Display the name for the active field:

        READ                         // Assuming field 1 is active
        ? GETFLDVAR()                // "VAR1"

     .  Within a UDF or KEYTRAP procedure:

        ? GETFLDVAR()                // "VAR1"

See Also: GETFLDROW() CURRENTGET() COUNTGETS()

 

Tools — GET/READ Functions

Introduction GET/READ Functions
COUNTGETS()  Determines the number of posted GET fields
CURRENTGET() Determines the number of the currently active GET field
GETFLDCOL()  Determines the screen column of a GET field
GETFLDROW()  Determines the row of a GET field on the screen
GETFLDVAR()  Determines the name of a GET field
GETINPUT()   Keyboard input function similar to a GET field
GETSECRET()  Keyboard input function for hidden input similar to a GET field
RESTGETS()   Restores GET settings from an array
RESTSETKEY() Restores SET KEY..TO settings from an array
SAVEGETS()   Saves the GET settings of the active environment
SAVESETKEY() Saves SET KEY..TO settings in an array