C H A P T E R 2 1
method returns a multiple-item target object by using the
, you can set the class of that target object to
to enable this special behavior. You'd do this using code like this:
There is a limitation to using the
data class, which is that this
data class handles data types of
only. If you want to
enable other data types, or restrict the data types to just a subset of these, you'll
need to create your own overview data class and register formats under that class.
Note that the overview-handling code discussed here is contained in
, so any format that you create can support this same
functionality. To use it, you must define a multiple-item data class and then register
formats under that data class.
Displaying an Auxiliary View
When the user chooses a format in the format picker, you may need to get
additional information from the user in the routing slip view. You can do this
by means of an auxiliary view template that you specify in the
of the routing format. If you specify a view template in this slot, when the format
is selected, this auxiliary view template is instantiated with the function
and is sent an
Figure 21-5 shows an example of the auxiliary view used with the built-in Memo
format for Note stationery in the Notes application. This view gets information to
be used for the Name and Subject fields of the memo header.
Auxiliary view example
If you need access to information about the item being routed, you can access the
slot in the auxiliary view. The system sets the
slot to the frame
that becomes the In/Out Box entry for the item being routed. For details on this
frame, see "Item Frame" (page 18-1) in Newton Programmer's Reference.