preferences function

preferences(

DOMAIN

)

The preferences( function retreives a list of preferences that have been stored.

Parameters

This function has one parameter:

domain – The domain of the preferences to retrieve. If left empty (or omitted entirely) all Panorama and operating system preferences will be listed. If this parameter contains "PANORAMA" (any capitalization) then only preferences stored by Panorama will be included (including any values stored by databases). For a list of other domains that can be accessed, use the info(“preferencedomains”) function.

Description

This function returns a carriage return separated list of available preferences in a domain. If the domain is omitted, then all Panorama and operating system preferences will be listed.

preferences()
preferences("")

If the domain is Panorama (any capitalization), then only preferences stored by Panorama will be included (including any values stored by databases).

preferences("panorama")

There are dozens of other preferences domains available on any system. The exact list of domains will depend on what software you have installed – for a complete list, use the info(“preferencedomains”) function. This example lists the preferences stored by the CUPS printing system.

preferences("org.cups.PrintingPrefs")

See Also

Automatic Startup Database -- automatically open one or more databases when Panorama is launched.
Confirmation Alerts -- Configuring alerts to confirm sensitive operations (deletions, etc.).
getapplicationinfo( -- retrieves the value of an item in the application's plist, or a list of all plist items.
getpreferenceclass( -- retrieves the class name of a preference value.
getpreferencevalue( -- retrieves the value of a preference.
info("preferencedomains") -- returns a carriage return delimited list of available preferences domains.
removepreferencevalues -- deletes one or more preference values.
Scripting Language Configuration -- configuring the scripting languages available to Panorama (Perl, PHP, Python and Ruby).
setpreferencevalues -- creates and/or modifies a preference value.
writepreference -- modifies a preference value.

History

Version	Status	Notes
10.0	New	New in this version.