[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    GetPrefs -- Get the current Intuition preferences structure.

SYNOPSIS
    Prefs = GetPrefs( PrefBuffer, Size )
    D0                A0          D0

    struct preferences *getprefs( struct preferences *, word );

FUNCTION
    Gets a copy of the current Intuition preferences structure.
    Writes the data into the buffer you specify.  The number of bytes you
    want copied is specified by the size argument.

    It is legal to take a partial copy of the preferences structure.
    The more pertinent preferences variables have been grouped near
    the top of the structure to facilitate the memory conservation
    that can be had by taking a copy of only some of the preferences
    structure.

    New for V36:  A new and more extensible method for supplying
    preferences has been introduced in v36, and relies on file
    system notification.  The Intuition preferences items rely
    also on the IPrefs program.  Certain elements of the
    preferences structure have been superceded by this new method.
    As much as possible, the preferences structure returned by
    GetPrefs() reflect the current state of preferences.  however,
    it is impossible to represent some of the V36-style preferences
    items using the existing preferences structure.

INPUTS
    PrefBuffer = pointer to the memory buffer to receive your copy of the
       Intuition preferences
    Size = the number of bytes in your PrefBuffer, the number of bytes
       you want copied from the system's internal Preference settings

RESULT
    Returns your parameter PrefBuffer.

BUGS

SEE ALSO
    getdefprefs(), setprefs()