Changed title from "Handling Carbon Events." Made minor content updates and bug fixes.

Added some information about HIView-based mouse tracking areas to Mouse Tracking Regions (Mac OS X v.10.2 and Later).

Described workaround trick for getting standard application event handlers when processing events manually.

Removed event parameters appendix (now documented with the event kinds in the API references).

Added link to Apple Events Programming Guide.

Added note to Standard Handlers describing the difference between default behavior and standard event handling for an event.

Updated art files.

Specified in the parameter appendix that kEventWindowContextualMenuSelect also contains the parameters available to kEventMouseDown.

Also removed superfluous section head.

Updated for Mac OS X 10.2.

Added text to Carbon Events Versus WaitNextEvent indicating that standard menu event and Apple event handlers are installed only when you call RunApplicationEventLoop.

Added warning to Creating and Registering an Event Handler that plugins must explictly remove any event handlers they install before being unloaded. Otherwise, the system may attempt to call event handler code that no longer exists. Added similar warning to Installing Timers.

Corrected error in Listing 3-4, adding an EventRef parameter to the CallNextEventHandler call.

Added new section, Queue-Synchronized Events (Mac OS X v.10.2 and Later).

Added note about the new kEventParamWindowMouseLocation parameter to Mouse Events.

Removed all suggestions to use Classic Event Manager functions such as Button and WaitMouseUp in Mouse Button Events, and replaced them with a warning that these functions use excessive processor time (especially on Mac OS X).

Replaced deprecated mouse tracking result constants (kMouseTrackingMousePressed/Released/Moved) in Tracking Mouse Movements with newer equivalents: kMouseTrackingMouseDown/Up/Dragged. Added new tracking result constants as well.

Added warning about the kMouseTrackingMouseMoved constant: The kMouseTrackingMouseMoved constant has been repurposed for Mac OS X version 10.2 and later. In earlier system software versions, kMouseTrackingMouseMoved was equivalent to the kMouseTrackingMouseDragged result, indicating that the mouse was moved while the mouse button was down. In Mac OS X 10.2. and later, you receive the kMouseTrackingMouseMoved tracking result if the user moves the mouse while the mouse button is up. If you have code that interprets kMouseTrackingMouseMoved in its older sense, you should update it before running it on Mac OS X version 10.2 or later.

Removed unnecessary GetMouse call in Listing 3-8.

Added new section Mouse Tracking Regions (Mac OS X v.10.2 and Later).

Added material about idle timers to Installing Timers, which are available in Mac OS X 10.2 and later.

Added information about the kEventParamPostTarget event parameter in Creating Your Own Events. Also updated information about how the standard event dispatcher handles unrecognized events (it sends them to the application event target).

Updated available event parameters in “Event Parameters and Types for Common Event Kinds.” Added event parameters for application events.

Added additional sections The Handler Stack and An Event Propagation Example to clarify how events are propagated through the containment hierarchy.

Removed note from Standard Handlers indicating that the standard handler acts like the outermost object in a containment hierarchy. The actual mechanism is a bit more subtle than that.

Added third item to the event handling list in The Event Model indicating that events that are not processed will be discarded.

Defined window dimension constants in Listing 3-2 to make the code compilable.

Clarified in Command Events that command events are first sent to the event target they are associated with (that is, the menu or control).

WWDC draft.

Document title changed to Handling Carbon Events from the Carbon Event Manager Handbook.

Correction: The Carbon Event Manager does not replace the functionality of the Notification Manager.

Terminology change: References to the “default event handler” changed to “standard event handler” to better match the API and internal usage.

System Requirements section moved to the introductory chapter. Also, the Carbon Event Manager is available in CarbonLib 1.1.1 and later, not 1.2 as previously stated.

Added Note to Standard Handlers (formerly Default Handlers) indicating that the standard window handler includes support for control events, and the standard application handler includes support for menu events.

In Carbon Events Versus WaitNextEvent, maximum timeout for WaitNextEvent should be 7FFFFFFF. Idle processing information changed to use null events instead of idle events.

In Event Classes and Kinds, clarified which handler actually calls SetPort and Begin/EndUpdate. It’s kEventWindowUpdate, not kEventDrawContent.

Indicated that RunApplicationEventLoop installs ths standard application event handler, which includes a simple quit Apple event handler in Executing the Event Loop.

Clarified in Creating and Registering an Event Handler that the event handler UPP is not automatically released; you must dispose of it yourself.

Added warning comment in Listing 3-4 to indicate that the standard handler for the window close event removes the window, you can’t attempt to access it as part of your post-processing.

Correction in Other Event Attributes: EventTime is a floating point number, not an integer.

In Command Events, command IDs were introduced with Mac OS 8.0, not 8.5 as stated. Also the myEvents parameter in the InstallApplicationEventHandler call needs an “&”. The commandID field of the commandStruct variable starts with a lower-case c, not upper case. Added note indicating that Interface Builder makes it easy to assign command IDs to controls and menu items.

In Text Events, the user focus event target is a valid event target that does not change. If you install a handler on this target, then any events targeted at the current user focus will automatically be sent to your handler before being sent to the actual event target that has the user focus.

Correction in Mouse Events: The coordinates of the mouse position in kEventParamMouseLocation are given in global coordinates, not local as previously stated.

Added Mac OS X only mask constants kEventKeyModifierNumLockMask and kEventKeyModifierFnMask to Table 3-1.

Correction in Installing Timers: Event handlers are not associated with a particular event loop. Also added clarification in the Note as to which functons will run the event loop.

In Processing Events Manually, clarified what handlers RunApplicationEventLoop installs: handlers to begin menu tracking, dispatch Apple events, and process the quit Apple event.

In Creating Your Own Events, indicated that you can pass 0 for the when parameter in CreateEvent, which specifies the current event time.

In “Event Parameters and Types for Common Event Kinds” updated text input event constant names to reflect latest header.

Preliminary review draft. Includes material from the older Carbon Events document.