SET( ) Function
Returns the status of various SET commands.
SET(cSETCommand [, 1 | cExpression | 2 | 3 | 4])
Parameters
cSETCommand
Specifies a character expression of the SET command for which you want to return information. The current setting of the specified command is returned as a character or numeric string.1 | cExpression | 2 | 3 | 4
Specifies additional information to return about a SET command. The values 1 and cExpression are identical; cExpression can be any expression that evaluates to a character type value.Note Including an argument does not return additional information for all SET commands, only those specifying values of 1, 2, 3, or 4 in the following table.
SET command Value returned ALTERNATE ON or OFF ALTERNATE, 1 FileName BELL, 1 cWAVFileName CARRY ON or OFF CENTURY ON or OFF CENTURY, 1 nCentury CENTURY, 2 ROLLOVER nYear CENTURY, 3 System Regional Calendar setting CLOCK ON or OFF CLOCK, 1 nRow and nColumn COMPATIBLE ON or OFF COMPATIBLE, 1 PROMPT or NOPROMPT COVERAGE, 1 FileName CURRENCY LEFT or RIGHT CURRENCY, 1 cCurrencySymbol DATE AMERICAN, ANSI, BRITISH/FRENCH, GERMAN, ITALIAN, JAPAN, USA, MDY, DMY, or YMD DATE, 1 Date Ordering:0 – MDY1 – DMY2 – YMD DELIMITERS ON or OFF DELIMITERS, 1 cDelimiters EVENTTRACKING ON or OFF EVENTTRACKING, 1 FileName FIELDS ON or OFF FIELDS, 1 FieldName1, FieldName2, ... FIELDS, 2 LOCAL or GLOBAL HELP ON or OFF HELP, 1 cFileName HELP, 2 cCollectionURL HELP, 3 SYSTEM KEY eExpression2, eExpression3 KEY, 1 eExpression2 KEY, 2 eExpression3 MESSAGE nRow MESSAGE, 1 cMessageText MOUSE ON or OFF MOUSE, 1 nSensitivity NOTIFY ON or OFF NOTIFY, 1 ON or OFF PRINTER ON or OFF PRINTER, 1 FileName or PortName PRINTER, 2 Default Windows printer name PRINTER, 3 Default Visual FoxPro printer name(specified in the Visual FoxPro Print or Print Setup dialog boxes) REFRESH nSeconds1 REFRESH, 1 nseconds2 REPROCESS Current session setting REPROCESS, 1 System session setting RESOURCE ON or OFF RESOURCE, 1 FileName TALK ON or OFF TALK, 1 WINDOW, NOWINDOW or WindowName TEXTMERGE ON or OFF TEXTMERGE, 1 cLeftDelimiter and cRightDelimiter TEXTMERGE, 2 cFileName TEXTMERGE, 3 SHOW/NOSHOW TEXTMERGE, 4 Evaluate source of TEXT ... ENDTEXT call and return TEXTMERGE nesting level. TOPIC cHelpTopicName | lExpression TOPIC, 1 NContextID
Return Values
Character or Numeric data type. SET( ) returns the value of a SET command.
Remarks
SET( ) recognizes the four-character abbreviation for all Visual FoxPro SET keywords, with the exception of HELPFILTER, which can be abbreviated to five characters. For example, you can use STAT and PRIN for SET STATUS and SET PRINTER, respectively.
The SET( ) function is identical to SYS(2001).
SET("CENTURY", 3)
passes a Calendar value of 2 (Gregorian (U.S.)) in a call to the Windows GetCalendarInfo( ) API.
See Also
DISPLAY STATUS | LIST | SET | SYS(2001) – SET ... Command Status