Unit 'intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#os4units]

SetPrefs

Set Intuition preferences data.

Declaration

Source position: intuition.pas line 3856

function SetPrefs(

  const Preferences: PPreferences;

  Size: LongInt;

  Inform: LongInt

):PPreferences;

Arguments

Size

  

The number of bytes of the buffer you want to be copied.

Inform

  

If True, all windows with IDCMP_NEWPREFSIDCMPFlags set get an IDCMP_NEWPREFS message.

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

GetDefPrefs

  

Get a copy of the the Intuition default Preferences.

GetPrefs

  

Get the current Intuition Preferences structure.


Documentation generated on: 2021-07-30