Manager: Event Manager


Carbon supports the majority of the Event Manager.

High-level events APIs (as contained in EPPC.h) are not supported. You should use Apple events instead.

Carbon does not support the diskEvt event. Support for volume mount and unmount events will be available in the Carbon Event Manager.

Carbon does not set the convertClipboardFlag in the EventRecord to indicate that the scrap has changed while the application was suspended. You should call the Scrap Manager function GetCurrentScrap instead.

Low-level event queue functions, such as GetEvQHdr and PPostEvent, are no longer supported.

Application-defined function-key procedures are not supported in Carbon.

Note that Carbon introduces a new event model to the Mac OS, with a new set of APIs. Developers are strongly encouraged to use the Carbon Event Manager APIs in place of the Event Manager APIs. The Carbon Event Manager offers a simple yet flexible approach to event handling that greatly reduces the amount of code needed to write a basic application. Morevover, the Carbon Event Manager's streamlined event handling enhances system performance on Mac OS X through more efficient allocation of processing time. Applications that use the Carbon Event Manager not only run better on Mac OS X, they help improve overall performance and responsiveness, creating a better experience for our customers.

Unsupported  AcceptHighLevelEvent

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events. Not available in CarbonLib. Not available in Mac OS X.

Supported  Button

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  CheckEventQueueForUserCancel

Available in CarbonLib 1.0.2 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisposeFKEYUPP

FKEYs are not supported in Carbon because they involve loading code from resources, which isn't supported under Carbon, and because very few applications use them.

Unsupported  DisposeGetNextEventFilterUPP

GetNextEvent (GNE) filters patch the GetNextEvent function and therefore are not supported in Carbon.

Unsupported  DisposeGetSpecificFilterUPP

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events.

Supported  EventAvail

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FlushEvents

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetCaretTime

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetCurrentKeyModifiers

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetDblTime

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetEvQHdr

Returns a global system data structure, so it will not be supported in the future. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetGlobalMouse

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetKeys

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetMouse

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetNextEvent

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetOSEvent

GetOSEvent is not supported in Carbon. Use the GetNextEvent function instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  GetPortNameFromProcessSerialNumber

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  GetProcessSerialNumberFromPortName

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  GetSpecificHighLevelEvent

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  InvokeFKEYUPP

FKEYs are not supported in Carbon because they involve loading code from resources, which isn't supported under Carbon, and because very few applications use them.

Unsupported  InvokeGetNextEventFilterUPP

Unsupported  InvokeGetSpecificFilterUPP

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events.

Supported  IsCmdChar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  KeyScript

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  KeyTranslate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMGetKbdLast

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMGetKbdType

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMGetKeyRepThresh

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMGetKeyThresh

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMSetKbdLast

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMSetKbdType

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMSetKeyRepThresh

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  LMSetKeyThresh

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  NewFKEYUPP

FKEYs are not supported in Carbon because they involve loading code from resources, which isn't supported under Carbon, and because very few applications use them.

Unsupported  NewGetNextEventFilterUPP

Unsupported  NewGetSpecificFilterUPP

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events.

Unsupported  OSEventAvail

OSEventAvail is not supported in Carbon. Use the EventAvail function instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  PostEvent

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PostHighLevelEvent

The High Level Event APIs (EPPC.h) are not supported in Carbon. Instead, use Apple events. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PPostEvent

Posting events in the Operating System event queue is not supported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetEventMask

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  StillDown

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  SystemClick

Desk accessories are not supported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  SystemEvent

Desk accessories are not supported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  SystemTask

In Carbon, the Event Manager automatically handles all task scheduling. Not available in CarbonLib. Not available in Mac OS X.

Supported  WaitMouseUp

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  WaitNextEvent

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.