getformcustompreferencenames(
getformcustompreferencenames(
DATABASE
,
FORM
)

The getformcustompreferencenames( function returns a list of custom preferences associated with a form.

Parameters

This function has two parameters:

database – is the database containing the form. If this parameter is `""` or missing, the current database is assumed.

form – is the form in question. If this parameter is `""` or missing, the current form is assumed.

Description

Any Panorama form can contain one or more custom preference values. These preference values are saved with the form, much like permanent variables are saved with a database. Each preference value has a name. Each form has its own separate custom preference values. Different forms can have preferences with the same name, or different names. Preference values can be set with the setformcustompreference statement.

The getformcustompreferencenames( function returns a list of custom preferences associated with a form. If you want the list of preference values in the current form, no parameters are required:

    getformcustompreferencenames()

If you need the list of preference values in a specific form (not the current form), one parameter is required, the form name.

    getformcustompreferencenames("Invoice XR23")

You can add a second parameter (on the front) to list preference value in a form in a different database. This example returns the list of preferences in the Labels form in the Customer List database.

    getformcustompreferencenames("Customer List","Labels")

See Also

- deleteformcustompreference -- deletes a form custom preference.
- getformcustompreference( -- returns the value of a form custom preference.
- setformcustompreference -- sets the value of a form custom preference.

History

Version | Status | Notes
10.0 | New | New in this version.