A custom component may have to store user preferences persistently.
To this end, the editor context object implements the method
getPreferences of the interface
IEditorContext. The method returns a
Struct object that is stored in the
EditorPreferences document of the current user.
You can modify this struct using the standard struct API
as described in Section 5.4.4, “Structs”.
The class PreferencesUtil provides two utility methods
for reading and writing complex objects in the preferences struct:
getPreferencesJSONProperty and
updatePreferencesJSONProperty.
These methods support strings, numbers, Boolean, contents,
and complex objects and arrays containing such values.
The Studio API uses these methods internally for
persisting saved searches (including custom filters),
open tabs, dashboard widget states, and bookmarks.
 |  |  |
 |