Routing Interface

Using Routing

Receiving Data

21

Incoming data arrives first as an entry in the In Box. If there is a public view
definition registered for the class of the entry, the item may then be viewed directly
in the In Box.

Generally, the

body

slot of every received item must have a

meaningful class. (This is not strictly required if the item has an

appSymbol

slot.) If

body

contains a frame, its

class

slot

identifies its data class. Items received from other Newton devices
generally have a

body.class

slot. For items received from

other systems, the transport must assign a meaningful class
(use

SetClass

).

An incoming item may be stored in the In Box until the user chooses to manually
put away the item into an application, or an incoming item may be transferred
automatically to an application as soon as the item arrives in the In Box. This is
controlled by the applications present on the Newton and described in detail in the
following sections.

If an In Box item contains an

appSymbol

slot, that slot identifies the receiving

application for the item. The system uses this slot to identify the default application
to which the item should be put away (if any). If the original item contained a

destAppSymbol

slot when submitted to the In Box, that slot is copied into the

appSymbol

slot to identify the application that should receive it. The receiving

transport does this before the item is passed to the In Box by using the transport
method

NewFromItem

.

These are the minimum steps you need to take to support receiving items through
the In/Out Box in your application:

Supply a

PutAwayScript

method in your application base view. When a user

chooses to put away an item to your application from the In/Out Box, the item is
passed to this method.

Register the data classes that your application can accept by using the

RegAppClasses

function in the application part

InstallScript

function.

Unregister using

UnRegTheseAppClasses

or

UnRegAppClasses

in the

application part

RemoveScript

function.

Automatically Putting Away Items

21

The first thing the In Box does with an incoming item is to determine which
applications might want to accept the item immediately. The In Box does this by
checking the In Box application registry to find out if any applications have
registered to accept such items; see the section "Registering to Receive Foreign