Use IACpushoutlineparam to call other programs with an outline parameter. To return an outline as the result of an Apple Event message, call IACreturnoutline. These routines follow the same calling conventions as routines implemented in iac.c, included in this package. Over 30 other routines are provided to traverse an outline, get or set the text of any headline, find out how many lines there are, build outlines and restructure outlines. We provide documentation for routines that are central to the transport of outlines over the Apple Event channel, but rely on the source code and comments to document the routines that deal with in-memory outline structures.
All routines operate on a global outlinerecord called outlinedata.
You can keep a lot of outlines around, just be sure that before you call one of the Outline Sharing Toolkit routines, that the outlinedata global points to the one you want worked on. Two routines, opPushOutline and opPopOutline, are provided so you can set the global without disturbing any other operations which may be in progress. Each outlinerecord contains a handle that links to the first summit in the outline structure. This handle is called hsummit. It points to a structure of headrecords, described in the following section.