Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 10 - eMate Multi-User Mode

Using Multi-user Mode

Applications must do a few things to support Classroom multi-user mode.

• When the application opens, check the current user and open the soup corresponding to that user. Note that you can name the application-created soups anything you want, but it is recommended that you use names created by the *GenSoupName method.
• The application should not show the filing folder tab when it opens and the unit is in Classroom mode. This user interface guideline is used to simplify the interface by removing the filing folder feature and prevents a user from deleting or changing the names of folders that might have been used by others.
• The application must provide a *GetBackupSoupNames method that returns an array of the names of the soups for the current user, so the Classroom Dock application can back up the data. If this method is not supplied, Classroom Dock cannot back up user's data.
• The application must be aware that the current user can change while the application is open. To handle this, the application can register (use *RegUserConfigChange) to be notified of changes to the user configuration variable KCurrentUser. Here's an example of a method that responds to a user change:

    func(changeSym) begin

   if changeSym = 'KCurrentUser then
      GetRoot().HomePage:MultiUserSwitch('newtWorks);
    end

The *MultiUserSwitch method closes and reopens the application when the user changes. This allows the application to begin displaying data for a different user.

• An application that works in Classroom mode can set a KClassroomAware slot in its base view to true, causing the application to be listed as one of the recommended applications for Classroom mode availability in the Edit Extras slip (which is accessed via the Teacher Setup application). Do not set the KClassroomAware slot unless you implement the other requirements in this section.

© Apple Computer, Inc.
26 APR 1997

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help