DlgStoreValues

Syntax

DlgStoreValues ValuesFile$, Identifier$

Remarks

On the Macintosh, stores string and numeric values for controls in custom dialog boxes so they may be retrieved later by DlgLoadValues. If you create a complex wizard, using DlgStoreValues and DlgLoadValues instead of SetPrivateProfileString and GetPrivateProfileString$() for storing and retrieving values entered by the user can improve performance significantly.

Argument	Explanation

ValuesFile$	The name of the file in which the values are stored. ValuesFile$ can include a path. If a path is not specified, Word looks for ValuesFile$ in the Preferences folder.
Identifier$	A string that identifies the set of stored values (this string is used when retrieving values with DlgLoadValues). Note that while you can store multiple sets of values for different dialog boxes in the same file, it is recommended for future cross-platform compatibility that you use one values file per dialog box.

The following rules determine which values Word stores:

Values for the following items are stored by default: check boxes, option groups, text boxes, list boxes, drop-down list boxes, and combo boxes. Values for all other items are not stored by default.
You can reverse the default behavior for most individual items by giving the item a string identifier that ends in 0 (zero). For example, you can store the value for a Text control (such as a tip in a wizard) or prevent the value for a check box from being stored. Note that .Item0 and .Item000 are examples of identifiers that end in 0 (zero), but .Item100 is not.
You cannot store values for picture, file preview, option button, and push button controls.

In Windows, DlgStoreValues is unavailable and generates an error.

For an example, see DlgLoadValues.

See Also

DlgLoadValues