Share via


SYS(3056) – Read Registry Settings

Forces Visual FoxPro to read its registry settings again and update itself with the current registry settings.

SYS(3056 [,1])

Return Values

Character

Parameters

  • 1
    Include the 1 option to update only from registry settings, with the exception of SET commands and file locations.

Remarks

Returns the empty string.

Visual FoxPro stores the Options dialog box settings in the Windows registry. You can also store additional Visual FoxPro configuration settings in a text file, normally named Config.fpw. Visual FoxPro is configured when it is started by reading these registry settings and its configuration file (if one exists).

The settings you specify in the Options dialog box are written to the registry when you choose Set As Default. Some settings, such as those for Syntax Coloring, are stored in the registry but have no corresponding SET commands. Other settings do have corresponding SET commands (such as SET BELL, SET CLOCK, and so on) that affect the Visual FoxPro environment. The settings made from the File Locations tab in the Options dialog box are also stored in the registry, and some are accessible through system variables such as _COVERAGE and _SAMPLES.

Issuing SYS(3056) updates information from the registry settings and the corresponding SET commands, registry settings from the Options dialog File Locations tab, and the Visual FoxPro configuration file (if one exists). SYS(3056) reads the registry information first, and then the configuration file.

Issuing SYS(3056,1) updates information from the Visual FoxPro registry settings that don't have corresponding SET commands. The SET commands, File Locations registry settings, and configuration file information aren't updated if the 1 argument is included.

Note that registry settings can also be changed directly through the Windows API. See the Windows API section of Solution.app, located in the Visual FoxPro ...\Samples\Solution directory, for an example of how you can use the Windows API to modify registry settings.

See Also

SET Command | Options Dialog Box | Read and Write Visual FoxPro Registry Values | Changing Configuration Settings in the Windows Registry