SetPrefs

Set Intuition preferences data.

Declaration

Source position: intuition.pas line 3856

Arguments

Function result

Returns your parameter buffer.

Description

Sets new preferences values. Copies the first Size bytes from your preferences buffer to the system preferences table, and puts them into effect.

The Inform parameter, if True, indicates that an IDCMP_NEWPREFS message is to be sent to all windows that have the IDCMP_NEWPREFSIDCMPFlags set.

It is legal to set a partial copy of the Preferences structure. The most frequently changed values are grouped at the beginning of the Preferences structure.

Note: A new and more extensible method for supplying Preferences has been introduced, and relies on file system notification. The Intuition preferences items rely also on the IPrefs program. Certain elements of the Preferences structure have been superseded by this new method. (Elements are generally superseded as new hardware or software features demand more information than fits in struct Preferences. Parts of struct Preferences must be ignored so that applications calling GetPrefs(), modifying some other part of struct Preferences, then calling SetPrefs(), don't end up truncating the extended data).

Pointer Preferences: Only the pointer from the initial SetPrefs() (i.e. devs:system-configuration) is heeded.

Palette Preferences: Color changes submitted through SetPrefs() are ignored after the first time IPrefs sends Intuition new style palette preferences.

FontHeight and LaceWB: These are only respected from devs:system-configuration.

View centering and size: Changes to ViewX/YOffset and Row/ColumnSizeChange only apply to the default monitor (NTSC or PAL), and not to other monitors such as Productivity.

Other fields may be superseded in the future.

See also