Inside Macintosh: Programmer's Guide to MacApp / Part 2 - Working With MacApp

Appendix C - Organization of MacApp's
Source Code

The source code in the MacApp class library is written almost entirely in C++. Related classes and support code are grouped by function and stored in standard C++ header files (such as UAppleEvents.h) and implementation files (such as UAppleEvents.cp). Largely for historical reasons, these header and implementation pairs are referred to as units, and many start with the letter U. (For more information on MacApp filenaming conventions, see "The Magic Five Files," beginning on page 675.)

A unit typically contains one or more related classes that perform the central function of the unit, along with support classes such as iterator classes and command classes.

This appendix lists MacApp's units and provides a brief description of the function provided by each unit. Units are grouped by their organization in the MacApp class library.

Unit name	Description
Core units
UMemory, BestFitHeap, MemoryHeap, ObjectHeap, PlatformMemory	Managing efficient, platform-independent, pointer-based memory allocation
CWDebug	Providing framework-level support for Metrowerks' CodeWarrior MW Debug debugger
MacAppTypes	Defining simple type declarations
NubInspectorHooks	Providing NubDispatch traps for inspector support
PascalString	Defining Pascal string-compatible string classes
Toolbox	Supplying CRGBColor definitions and assorted Toolbox convenience routines
UAssociation	Managing lists of key-value entries
UClassDesc, UClassDescIterator	Providing runtime type information for application objects
UDebug, UDebugView	Providing MacApp debugger functions and interface
UDependencies	Propagating change notification
UDynamicArray	Providing efficient storage and operations on dynamic arrays
UFailure	Handling exception conditions
UGeometry, Geometry	Handling geometry class definitions for points, rectangles, and so on
UIterator	Providing iteration over arrays or lists of items
UList, UListIterator	Building lists on top of dynamic array structure; operating on sorted lists
UniversalStartup	Providing safe, processor-independent code for starting up an application
UObject	Serving as superclass and providing functions needed by most classes
UPatch	Providing a processor-independent mechanism for patching ROM traps
UPointerObject	Providing operations on pointer-based objects
USegments	Providing safe, efficient segment operations (68K applications only)
UStream	Managing data streams
UTheDebugger	Providing framework-level support for Jasik's The Debugger
MPW tools
UCPlusTool	Supplying a framework for building MPW tools
Framework
UAdorners	Drawing frames and other view adornments
UAppleEvents	Describing, manipulating, and sending Apple events
UBehavior	Modifying the behavior of event-handler objects
UBusyCursor	Changing the cursor image while the application is busy
UClipboardMgr	Managing Clipboard operations
UCommand	Performing command operations that can be done, undone, and redone
UCommandHandler	Managing applicationwide command operations that support undo
UControl	Providing abstract control operations
UDesignator	Designating sections of a document, including selections
UDeskScrapView	Supporting a default Clipboard
UDialogBehavior	Providing dialog-box behavior
UDocument	Managing document objects
UDragDrop, UDragDropBehavior	Providing support for drag-and-drop operations
UDrawingEnvironment	Setting and storing characteristics of a graphics environment
UErrorMgr	Handling error messages
UEvent	Describing and manipulating basic operating system events
UEventHandler	Responding to dispatched events
UFile	Handling file operations
UFloatWindow, FloatWindow	Supporting floating windows
UMacAppGlobals	Providing miscellaneous global declarations
UMacAppUtilities	Providing miscellaneous global routines
UMenuMgr	Supporting programmatic menu creation and modification
UOSAScript	Representing and manipulating scripts
UPrintHandler	Supporting simple printing
UPrinting	Representing and manipulating printer objects; handling customizable printing
UScriptableObject	Mixing in with event-handler objects to support Apple events
UScripting	Supporting the Apple event object model
UScroller	Managing scroller objects
UView	Displaying and manipulating data in nested views
UViewServer	Managing window and view creation
UWindow	Supporting basic Macintosh window operations
Documents
UEditionDocument	Providing Edition Manager support for documents that implement publish and subscribe
UFileBasedDocument	Handling disk-based document operations
UFileHandler	Mediating between files and documents
USection, USectionMgr	Representing and managing section events
UTEDocument	Adding text-editing capability to document objects (from DemoText sample application)
Views
UDialog	Providing views and commands used with dialog boxes
UGrabberTracker	Supporting scrolling with grabber-hand cursor
UGridView	Displaying arrays of information
UKeySelectionBehavior	Providing alphabetic type-ahead in text list views
UMenuView	Supporting custom menu creation
UPopup	Managing pop-up menus
USynchScroller	Synchronizing multiple scrollers
UTabBehaviors	Providing tabbing support between text entry views
UTearOffMenuView	Supplying tear-off menu operations
UTECommands	Supporting text-editing commands
UTEView	Supporting text-editing views
Application
UApplication	Handling application-level tasks
UVUAssist	Providing a hook for Virtual User assistance (to automate testing and other operations)
Mail
UMailable	Mixing in with document classes to provide electronic-mail functions
UMailableDocument	Working with MMailable to turn a document into electronic mail
UMailer	Representing a PowerTalk mailer attached to a document
UMailerView	Mediating between a MacApp mailer view and an AOCE view
UMailingApplication	Providing applicationwide Standard Mail Package support