C H A P T E R 1 5
Using the Filing Service
Specifying the Target
method identifies the current target and target view to the
system. Depending on your needs, you can use the default version of this method
or override it.
If you use the default version, your application's base view must supply
slots that you update whenever the target or target view
changes. If you override this method, you provide these slots in the result frame
that it returns, rather than in your application's base view. These slots provide the
same information regardless of whether they reside in the
method's result frame or in the application's base view.
Creating the Target Slot
slot contains the data item with which the user is working, such as the
soup entry that represents the currently displayed note to file. If there is no active
item, this slot must have the value
Your application must update the value of the
slot every time the user
views a new item. Because the selection of a new item is an application-specific
detail, it is difficult to recommend a means of updating this slot that is appropriate
for every application; however, it is common to update the value of this slot from
method of the active view.
Creating the TargetView Slot
slot contains the view that receives messages from the Filing
service and can manipulate the target. The application's base view is usually an
appropriate value for this slot.
Overriding the GetTargetInfo Method
You can implement your own
method if the default version
supplied by the system is not suitable for your application's needs. For example, if
your application images data items in floating windows or displays more than one
data item at a time, you probably need to supply a
can return an appropriate target and target view in those situations.
You must override the
method in order to move an item to
another store when it is filed. The result frame returned by your
override can include an optional
slot that specifies the store on
which an item is to reside when it is filed.
To override this method, create in your application base view a slot named
and implement this method as specified in the description of
method (page 12-11) in