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