@...Get

Creates a GET object and displays it to the screen

Syntax

@ <nRow>,<nCol> [SAY <cSay> [PICTURE <cSayPict>] COLOR <cSayColor> ]
GET <xVar> [PICTURE <cGetPict>] [WHEN <lWhen>] [COLOR <cGetColor>]
[VALID <lValid> / RANGE <xStart>,<xEnd>]

Arguments

<nRow> The row coordinate.

<nCol> The column coordinate.

<cSay> Message to display.

<cSayPict> Character expression of PICTURE displayed.

<cSayColor> Color to be Used for the SAY expression.

<xVar> An variable/field name.

<cGetPict> Character expression of PICTURE to get.

<lWhen> Logical expression to allow GET.

<lValid> Logical expression to validate GET input.

<xStart> Lower RANGE value.

<xEnd> Upper RANGE value.

<cGetColor> Color string to be used for the GET expression.

Returns

None

Description

This command adds a GET object to the reserved array variable named GETLIST[] and displays it to the screen. The field or variable to be added to the GET object is specified in <xVar> and is displayed at row, column coordinate <nRow>, <nCol>.

If the SAY clause is used <cSay> will be displayed starting at <nRow>,<nCol>, with the field variable <xVar> displayed at ROW(), COL()+ 1. If <cSayPicr>, the picture template for the SAY expression <cSay>, is used, all formatting rules contained will apply See the TRANSFORM I function for futher information.

If <cGetPict> is specified, the PICTURE clause of <xVar> will be used for the GET object and all formatting rules will apply. See the table below for GET formatting rules.

If the WHEN clause is specified,when <lWhen> evaluates to a logical true (.T.) condition, the GET object will he activated otherwise the GET object will be skipped and no information will be obtained via the screen. The name of a user-defined function returning a logical true (.T.) or false ( F.) or a code block may be ,specified in <lWhen> This clause not activated until a READ command or READMODAL() function call is issued.

If the VALID clause is specified and <lValid> evaluates to it logical true (.T.) condition the current GET will be considered valid and the get operation will continue onto the next active GET object. If not, the cursor will remain on this GET object until aborted or until the condition in <lValid> evaluates to true (.T.). The name of a user-defined function returning a logical true (.T.) or false (.F.) or it code block may be specified in <lValid>. This clause is not activated until a READ command or READMODAL( ) function call is issued.

If the RANGE clause is specified instead of the VALID clause, the two inclusive range values for <xVar> must be specified in <xStart> and <xEnd>. Id <xVar> is a date data type,<xStart> and <xEnd> must also be date data types; if <xVar> is a numeric data type <xStart> and <xEnd> must also be numeric data types. If a value fails the RANGE test ,a message of OUT OF RANGE will appear in the SCOREBOARD area (row = 0, col = 60).The RANGE message may be turned off it the SET SCOREBOARD command or SET() function appropriately toggled.

NOTE GET functions/formatting rules:

@AAllows only alphabetic characters.
@BNumbers will be left justified
@CAll positive numbers will be followes by CR.
@DAll dates will be in the SET DATE format.
@EDates will be in British formal: numbers in European format.
@KAllows a suggested value to be seen within the GET
area but clears It if any noncu sor key is pressed when
the cursor is in the first Position in the GET area.
@RNontemplate characters will be inserted.
@S<nSize>Allows horizontal scrolling of a field or variable that
is <nSize> characters wide.
@XAll negative numbers will be followed by DB
@ZDisplays zero values as blanks.
@!Forces uppercase lettering
@(Displays negative numbers in parentheses with leading spaces.
@)Displays negative numbers in parentheses without leading spaces.

GET templates/formatting rules:

AOnly alphabetic characters allowed.
NOnly alphabetic and numeric characters allowed
XAny character allowed.
LOnly T or F allowed For logical data.
YOnly Y or N allowed for logical data.
9Only digits, including signs, will be allowed.
#Only digits, signs. and spaces will he allowed.
!Alphabetic characters are converted to Uppercase.
$Dollar will be displayed in place of leading
spaces for numeric data types.
*Asterisk,, will Be displayed in place of leading spaces
for numeric data types.
.Position of decimal point.
,Position of comma.
Format PICTURE functions may he grouped together as well as used in Conjunction with a PICTURE templates;however, a blank space must be included in the PICTURE string if there are both functions and templates.
Examples
      Function Main()
      Local cVar:=Space(50)
      Local nId:=0
      cls
      @ 3,1 SAY "Name" GET cVar PICTURE "@!S 30"
      @ 4,1 SAY "Id"   GET nId  PICTURE "999.999"
      READ
      ? "The name you entered is",cVar
      ? "The id you entered is",nId
      RETURN NIL
Tests
      See Examples
Status

Ready

Compliance

This command is Ca-Clipper compatible

Platforms

All

See Also