Text preview for : 19770722_Additional_Hints_about_PNRs.pdf part of xerox 19770722 Additional Hints about PNRs xerox sdd memos_1977 19770722_Additional_Hints_about_PNRs.pdf



Back to : 19770722_Additional_Hints | Home

XEROX
INFORMATION PRODUCTS GROUP
Systems Development Division
July 22. 1977




XEROX SDD ARCHIVES
To: Tools Group I have read and understood
Pages _________ To _________
From: Bruce Parsley. SD/PARe
Reviewer Date
Subject: Additional Hints about PNRs
'-----
, of Pages _ _ Ref. "ttl <;, DD ~ 281<,

Stored: PNRsHints.memo




Here are some "hints" for tool writers concerning Processing Notification Routines
(PNRs). The material in this memo will be incorporated into the next release of the
TEX spec. You should read the material in that spec in section 5.2 (from about half
way down page 6 to the end of the section on page 7). This memo assumes a
familiarity with that material (and with some of the material in the Tool User Interface
(TUI) and Windows specs).

A tool writer should do something like the following:

Somewhere in your tool, write one or more PNRs. They are normal Mesa
procedures (subroutines) that must have calling sequences as specified by
CursorPnrType or PbkPnrType.

Now create a SubwindowObject. The routine CreateWindow makes one
subwindow besides the window. The routines CreateSubwindow and
EnlinkSubwindow may be used to get more subwindows in a window.

You must create a PNRsObject. This may be done by declaring a (global)
variable of that type or by using AllocateHeapNode.

Then you should associate a PNRsObject with each of your subwindows. The
way to do this is something like the following: mySubwindow.pnrs +- @myPNRs;

Now you should fill each of the fields of each of your PNRsObjects. The
encouraged method is to call one or more of the TVI routines that set up their .'
own PNRs in your subwindows' PNRsObjects. In Release 3.0 of the Tools