Xbasic

A5_LOAD_SETTINGS Function

Syntax

P a5_load_settings(C setting_name ,P dot_var_name [,C dictionary ])

Arguments

setting_name

The name of the setting, which becomes the record name in the dictionary table.

dot_var_name

The name of the dot variable containing the setting.

dictionary

Optional. Default = dictionary (.ALB file) for current database. The dictionary that will contain the setting.

Description

Reads the contents of a setting in a dictionary into a 'dot_variable'. Setting created by A5_SAVE_SETTINGS(). Record name is 'setting_name' and type is 'SAVU'.

Discussion

The A5_LOAD_SETTINGS() method loads settings that are stored in a dictionary by A5_SAVE_SETTINGS() into a Dot_Variable. The type of the record in the dictionary table is "SAVU".

Example

dim mysettings as P
dim mysettings.computer as C
dim retrieve_settings as P
mysettings.computer = "Compaq"
a5_save_settings("Desktop computer", mysettings)
a5_load_settings("Desktop computer", retrieve_settings)
? retrieve_settings
= computer = "Compaq"

Limitations

Desktop applications only.

See Also