开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
CarbonEvents.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：62k
源码类别：

多媒体编程

开发平台：

Visual C++

CarbonEvents.h：源码内容
  1. /*
  2.      File:       CarbonEvents.h
  3.  
  4.      Contains:   Carbon Event Manager
  5.  
  6.      Version:    Technology: Version 1.0
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1999-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __CARBONEVENTS__
  18. #define __CARBONEVENTS__
  20. #ifndef __EVENTS__
  21. #include "Events.h"
  22. #endif
  24. #ifndef __MENUS__
  25. #include "Menus.h"
  26. #endif
  28. #ifndef __CONTROLS__
  29. #include "Controls.h"
  30. #endif
  35. #if PRAGMA_ONCE
  36. #pragma once
  37. #endif
  39. #ifdef __cplusplus
  40. extern "C" {
  41. #endif
  43. #if PRAGMA_IMPORT
  44. #pragma import on
  45. #endif
  47. #if PRAGMA_STRUCT_ALIGN
  48.     #pragma options align=mac68k
  49. #elif PRAGMA_STRUCT_PACKPUSH
  50.     #pragma pack(push, 2)
  51. #elif PRAGMA_STRUCT_PACK
  52.     #pragma pack(2)
  53. #endif
  55. /*======================================================================================*/
  56. /*  EVENT COMMON                                                                        */
  57. /*======================================================================================*/
  60. enum {
  61.     eventAlreadyPostedErr       = -9860,
  62.     eventClassInvalidErr        = -9862,
  63.     eventClassAlreadyExistsErr  = -9863,
  64.     eventClassIncorrectErr      = -9864,
  65.     eventClassInvalidVersionErr = -9865,
  66.     eventHandlerAlreadyInstalledErr = -9866,
  67.     eventCantInstallHandlerErr  = -9867,
  68.     eventInternalErr            = -9868,
  69.     eventKindIncorrectErr       = -9869,
  70.     eventDataTagNotSupportedErr = -9870,
  71.     eventDataSizeMismatchErr    = -9871
  72. };
  74. /*======================================================================================*/
  75. /*  EVENT CORE                                                                          */
  76. /*======================================================================================*/
  77. /*--------------------------------------------------------------------------------------*/
  78. /*  o Event Flags, options                                                              */
  79. /*--------------------------------------------------------------------------------------*/
  81. typedef SInt16 EventPriority;
  82. enum {
  83.     kEventPriorityLow           = 0,
  84.     kEventPriorityStandard      = 1,
  85.     kEventPriorityHigh          = 2
  86. };
  89. typedef UInt32 EventAttributes;
  90. enum {
  91.     kEventAttributeNone         = 0,
  92.     kEventAttributeUserEvent    = (1 << 0),
  93.     kEventAttributeRouteToUserFocus = (1 << 1)
  94. };
  96. enum {
  97.     kEventLeaveInQueue          = false,
  98.     kEventRemoveFromQueue       = true
  99. };
  101. /*--------------------------------------------------------------------------------------*/
  102. /* o Event Times                                                                        */
  103. /*                                                                                      */
  104. /* EventTime is in seconds since boot. Use the constants to make life easy.             */
  105. /*--------------------------------------------------------------------------------------*/
  106. typedef double                          EventTime;
  107. typedef EventTime                       EventTimeout;
  108. typedef EventTime                       EventTimerInterval;
  110. #define kEventDurationSecond            1.0
  111. #define kEventDurationMillisecond       kEventDurationSecond / 1000
  112. #define kEventDurationMicrosecond       kEventDurationSecond / 1000000
  113. #define kEventDurationNanosecond        kEventDurationSecond / 1000000000
  114. #define kEventDurationMinute            kEventDurationSecond * 60
  115. #define kEventDurationHour              kEventDurationMinute * 60
  116. #define kEventDurationDay               kEventDurationHour * 24
  117. #define kEventDurationNoWait            0.0
  118. #define kEventDurationForever           -1.0
  120. /* Helpful doodads to convert from and to ticks from event times*/
  121. #ifdef __cplusplus
  122.     inline EventTime TicksToEventTime( UInt32 t ) { return ( (t) / 60.0 ); }
  123.     inline UInt32 EventTimeToTicks( EventTime t ) { return (UInt32)( (t) * 60 ); }
  124. #else
  125.     #define TicksToEventTime( t )   (EventTime)( (t) / 60.0 )
  126.     #define EventTimeToTicks( t )   (UInt32)( (t) * 60 )
  127. #endif  /* defined(__cplusplus) */
  130. /*--------------------------------------------------------------------------------------*/
  131. /* EventTypeSpec structure                                                              */
  132. /*                                                                                      */
  133. /* This structure is used in many routines to pass a list of event types to a function. */
  134. /* You typically would declare a const array of these types to pass in.                 */
  135. /*--------------------------------------------------------------------------------------*/
  137. struct EventTypeSpec {
  138.     UInt32                          eventClass;
  139.     UInt32                          eventKind;
  140. };
  141. typedef struct EventTypeSpec            EventTypeSpec;
  143. /* MouseTrackingResults returned from TrackMouse*/
  146. typedef UInt16 MouseTrackingResult;
  147. enum {
  148.     kMouseTrackingMousePressed  = 1,
  149.     kMouseTrackingMouseReleased = 2,
  150.     kMouseTrackingMouseExited   = 3,
  151.     kMouseTrackingMouseEntered  = 4,
  152.     kMouseTrackingMouseMoved    = 5
  153. };
  155. typedef struct OpaqueEventRef*          EventRef;
  157. typedef UInt32                          EventClassID;
  158. typedef UInt32                          EventClass;
  159. typedef UInt32                          EventType;
  160. /*--------------------------------------------------------------------------------------*/
  161. /*    o EventLoop                                                 */
  162. /*--------------------------------------------------------------------------------------*/
  163. typedef struct OpaqueEventLoopRef*      EventLoopRef;
  164. EXTERN_API( EventLoopRef )
  165. GetCurrentEventLoop             (void);
  167. EXTERN_API( EventLoopRef )
  168. GetMainEventLoop                (void);
  170. /*--------------------------------------------------------------------------------------*/
  171. /*  o Low-level event blocking                                                          */
  172. /*--------------------------------------------------------------------------------------*/
  174. EXTERN_API( void )
  175. BlockEventLoop                  (EventTimeout           timeout);
  177. EXTERN_API( void )
  178. WakeEventLoop                   (void);
  180. EXTERN_API( Boolean )
  181. BlockUntilNextEvent             (EventTimeout           timeout,
  182.                                  Boolean                pullEvent,
  183.                                  EventRef *             outEvent);
  185. EXTERN_API( Boolean )
  186. BlockUntilNextEventMatchingList (UInt32                 numTypes,
  187.                                  const EventTypeSpec *  list,
  188.                                  EventTimeout           timeout,
  189.                                  Boolean                pullEvent,
  190.                                  EventRef *             outEvent);
  192. /*--------------------------------------------------------------------------------------*/
  193. /*  o Core event lifetime APIs                                                          */
  194. /*--------------------------------------------------------------------------------------*/
  196. EXTERN_API( EventRef )
  197. CopyEvent                       (EventRef               inOther);
  199. EXTERN_API( EventRef )
  200. RetainEvent                     (EventRef               inEvent);
  202. EXTERN_API( UInt32 )
  203. GetEventRetainCount             (EventRef               inEvent);
  205. EXTERN_API( void )
  206. ReleaseEvent                    (EventRef               inEvent);
  208. /*--------------------------------------------------------------------------------------*/
  209. /*  o Getters for 'base-class' event info                                               */
  210. /*--------------------------------------------------------------------------------------*/
  212. EXTERN_API( UInt32 )
  213. GetEventClass                   (EventRef               inEvent);
  215. EXTERN_API( UInt32 )
  216. GetEventKind                    (EventRef               inEvent);
  218. EXTERN_API( EventAttributes )
  219. GetEventAttributes              (EventRef               inEvent);
  221. EXTERN_API( EventTime )
  222. GetEventTime                    (EventRef               inEvent);
  224. EXTERN_API( UInt32 )
  225. GetEventPriority                (EventRef               inEvent);
  227. /*--------------------------------------------------------------------------------------*/
  228. /*  o Setters for 'base-class' event info                                               */
  229. /*--------------------------------------------------------------------------------------*/
  230. EXTERN_API( OSStatus )
  231. SetEventTime                    (EventRef               inEvent,
  232.                                  EventTime              inTime);
  235. /*--------------------------------------------------------------------------------------*/
  236. /*  o Getting/setting common event data via tags                                        */
  237. /*                                                                                      */
  238. /*  NOTE: THIS STUFF IS NOT YET ACTIVE. DO NOT ATTEMPT TO USE IT.                       */
  239. /*--------------------------------------------------------------------------------------*/
  240. enum {
  241.     kEventTagKeyModifiers       = FOUR_CHAR_CODE('mods'),       /* UInt32*/
  242.     kEventTagMouseLocation      = FOUR_CHAR_CODE('mloc')        /* Point*/
  243. };
  245. typedef UInt32                          EventDataTag;
  246. EXTERN_API( OSStatus )
  247. GetEventDataByTag               (EventRef               inEvent,
  248.                                  EventDataTag           inKey,
  249.                                  void *                 buffer,
  250.                                  Size                   bufferSize,
  251.                                  Size *                 actualSize) /* can be NULL */;
  253. EXTERN_API( OSStatus )
  254. SetEventDataByTag               (EventRef               inEvent,
  255.                                  EventDataTag           inKey,
  256.                                  void *                 buffer,
  257.                                  Size                   bufferSize);
  259. /* Common, type-safe wrappers for the above...*/
  261. EXTERN_API( OSStatus )
  262. GetEventKeyModifiers            (EventRef               inEvent,
  263.                                  UInt32 *               outModifiers);
  265. EXTERN_API( OSStatus )
  266. SetEventKeyModifiers            (EventRef               inEvent,
  267.                                  UInt32                 inModifiers);
  269. EXTERN_API( OSStatus )
  270. GetEventMouseLocation           (EventRef               inEvent,
  271.                                  Point *                outMouseLoc);
  273. EXTERN_API( OSStatus )
  274. SetEventMouseLocation           (EventRef               inEvent,
  275.                                  Point                  inMouseLoc);
  277. /*--------------------------------------------------------------------------------------*/
  278. /*  o Event Queue routines (posting, finding, flushing)                                 */
  279. /*--------------------------------------------------------------------------------------*/
  281. typedef CALLBACK_API( Boolean , EventComparatorProcPtr )(EventRef inEvent, void *inCompareData);
  282. typedef STACK_UPP_TYPE(EventComparatorProcPtr)                  EventComparatorUPP;
  283. #if OPAQUE_UPP_TYPES
  284.     EXTERN_API(EventComparatorUPP)
  285.     NewEventComparatorUPP          (EventComparatorProcPtr  userRoutine);
  287.     EXTERN_API(void)
  288.     DisposeEventComparatorUPP      (EventComparatorUPP      userUPP);
  290.     EXTERN_API(Boolean)
  291.     InvokeEventComparatorUPP       (EventRef                inEvent,
  292.                                     void *                  inCompareData,
  293.                                     EventComparatorUPP      userUPP);
  295. #else
  296.     enum { uppEventComparatorProcInfo = 0x000003D0 };               /* pascal 1_byte Func(4_bytes, 4_bytes) */
  297.     #define NewEventComparatorUPP(userRoutine)                      (EventComparatorUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppEventComparatorProcInfo, GetCurrentArchitecture())
  298.     #define DisposeEventComparatorUPP(userUPP)                      DisposeRoutineDescriptor(userUPP)
  299.     #define InvokeEventComparatorUPP(inEvent, inCompareData, userUPP)  (Boolean)CALL_TWO_PARAMETER_UPP((userUPP), uppEventComparatorProcInfo, (inEvent), (inCompareData))
  300. #endif
  301. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  302. #define NewEventComparatorProc(userRoutine)                     NewEventComparatorUPP(userRoutine)
  303. #define CallEventComparatorProc(userRoutine, inEvent, inCompareData) InvokeEventComparatorUPP(inEvent, inCompareData, userRoutine)
  304. /*
  305.    PostEventToQueue retains the given event. You would normally release it after calling
  306.    this function.
  307. */
  308. EXTERN_API( OSStatus )
  309. PostEventToQueue                (EventRef               inEvent,
  310.                                  EventPriority          inPriority);
  312. EXTERN_API( Boolean )
  313. IsEventInQueue                  (EventRef               inEvent);
  315. EXTERN_API( OSStatus )
  316. FlushEventsMatchingListFromQueue (UInt32                inNumTypes,
  317.                                  const EventTypeSpec *  inList);
  319. EXTERN_API( OSStatus )
  320. FlushSpecificEventsFromQueue    (EventComparatorUPP     comparator,
  321.                                  void *                 compareData);
  323. EXTERN_API( void )
  324. FlushEventQueue                 (void);
  326. /*
  327.    Remove EventFromQueue removes the event from the event queue and releases it. If you
  328.    want to keep the event around, you should make sure to copy or retain it.
  329. */
  331. EXTERN_API( void )
  332. RemoveEventFromQueue            (EventRef               inEvent);
  334. EXTERN_API( EventRef )
  335. FindSpecificEventInQueue        (EventComparatorUPP     comparator,
  336.                                  void *                 compareData);
  338. EXTERN_API( UInt32 )
  339. GetNumEventsInQueue             (void);
  341. /*--------------------------------------------------------------------------------------*/
  342. /*  o Helpful utilities                                                                 */
  343. /*--------------------------------------------------------------------------------------*/
  344. EXTERN_API( EventTime )
  345. GetCurrentEventTime             (void);
  347. EXTERN_API( Boolean )
  348. IsUserCancelEventRef            (EventRef               event);
  350. EXTERN_API( Boolean )
  351. CheckEventQueueForUserCancel    (void);
  353. EXTERN_API( OSStatus )
  354. TrackMouseLocation              (GrafPtr                port, /* can be NULL */
  355.                                  Point *                outPt,
  356.                                  MouseTrackingResult *  result);
  358. EXTERN_API( OSStatus )
  359. TrackMouseRegion                (GrafPtr                port, /* can be NULL */
  360.                                  RgnHandle              region,
  361.                                  Boolean *              wasInRgn,
  362.                                  MouseTrackingResult *  result);
  364. EXTERN_API( Boolean )
  365. ConvertEventRefToEventRecord    (EventRef               inEvent,
  366.                                  EventRecord *          outEvent);
  368. EXTERN_API( Boolean )
  369. IsEventInMask                   (EventRef               inEvent,
  370.                                  EventMask              inMask);
  372. EXTERN_API( EventTime )
  373. GetLastUserEventTime            (void);
  375. /*--------------------------------------------------------------------------------------*/
  376. /*  o Timers                                                                            */
  377. /*--------------------------------------------------------------------------------------*/
  378. /* Timers, the new null processing mechanism.*/
  379. /* Not just good, but good for ya. */
  381. typedef struct OpaqueEventLoopTimerRef*  EventLoopTimerRef;
  382. typedef CALLBACK_API( void , EventLoopTimerProcPtr )(EventLoopTimerRef inTimer, void *inUserData);
  383. typedef STACK_UPP_TYPE(EventLoopTimerProcPtr)                   EventLoopTimerUPP;
  384. #if OPAQUE_UPP_TYPES
  385.     EXTERN_API(EventLoopTimerUPP)
  386.     NewEventLoopTimerUPP           (EventLoopTimerProcPtr   userRoutine);
  388.     EXTERN_API(void)
  389.     DisposeEventLoopTimerUPP       (EventLoopTimerUPP       userUPP);
  391.     EXTERN_API(void)
  392.     InvokeEventLoopTimerUPP        (EventLoopTimerRef       inTimer,
  393.                                     void *                  inUserData,
  394.                                     EventLoopTimerUPP       userUPP);
  396. #else
  397.     enum { uppEventLoopTimerProcInfo = 0x000003C0 };                /* pascal no_return_value Func(4_bytes, 4_bytes) */
  398.     #define NewEventLoopTimerUPP(userRoutine)                       (EventLoopTimerUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppEventLoopTimerProcInfo, GetCurrentArchitecture())
  399.     #define DisposeEventLoopTimerUPP(userUPP)                       DisposeRoutineDescriptor(userUPP)
  400.     #define InvokeEventLoopTimerUPP(inTimer, inUserData, userUPP)   CALL_TWO_PARAMETER_UPP((userUPP), uppEventLoopTimerProcInfo, (inTimer), (inUserData))
  401. #endif
  402. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  403. #define NewEventLoopTimerProc(userRoutine)                      NewEventLoopTimerUPP(userRoutine)
  404. #define CallEventLoopTimerProc(userRoutine, inTimer, inUserData) InvokeEventLoopTimerUPP(inTimer, inUserData, userRoutine)
  405. EXTERN_API( OSStatus )
  406. InstallEventLoopTimer           (EventLoopRef           inEventLoop,
  407.                                  EventTimerInterval     inFirstFire,
  408.                                  EventTimerInterval     inInterval,
  409.                                  EventLoopTimerUPP      inTimerProc,
  410.                                  void *                 inUserData,
  411.                                  EventLoopTimerRef *    outRef);
  413. EXTERN_API( OSStatus )
  414. RemoveEventLoopTimer            (EventLoopTimerRef      inTimer);
  416. EXTERN_API( OSStatus )
  417. SetEventLoopTimerNextFireTime   (EventLoopTimerRef      inTimer,
  418.                                  EventTimerInterval     nextFire);
  421. /*======================================================================================*/
  422. /*  EVENT CLASSES                                                                       */
  423. /*======================================================================================*/
  424. enum {
  425.     kEventClassMouse            = FOUR_CHAR_CODE('mous'),
  426.     kEventClassKeyboard         = FOUR_CHAR_CODE('keyb'),
  427.     kEventClassTextInput        = FOUR_CHAR_CODE('text'),
  428.     kEventClassApplication      = FOUR_CHAR_CODE('appl'),
  429.     kEventClassEPPC             = FOUR_CHAR_CODE('eppc'),
  430.     kEventClassMenu             = FOUR_CHAR_CODE('menu'),
  431.     kEventClassWindow           = FOUR_CHAR_CODE('wind'),
  432.     kEventClassControl          = FOUR_CHAR_CODE('cntl'),
  433.     kEventClassCommand          = FOUR_CHAR_CODE('cmds')
  434. };
  436. /* Mouse Events */
  437. enum {
  438.     kEventLeftMouseDown         = 1,
  439.     kEventLeftMouseUp           = 2,
  440.     kEventRightMouseDown        = 3,
  441.     kEventRightMouseUp          = 4,
  442.     kEventMouseMoved            = 5,
  443.     kEventLeftMouseDragged      = 6,                            /* mouse moved while button down*/
  444.     kEventRightMouseDragged     = 7,
  445.     kEventMouseEntered          = 8,
  446.     kEventMouseExited           = 9,
  447.     kEventMouseWheelMoved       = 10                            /* placeholder. Not yet operational, unlike the new Death Star.*/
  448. };
  450. enum {
  451.     kEventMouseButtonPrimary    = 0,                            /* only button for a one-button mouse (usually left button for multi-button mouse)*/
  452.     kEventMouseButtonSecondary  = 1,                            /* usually right button for a multi-button mouse*/
  453.     kEventMouseButtonTertiary   = 2                             /* usually middle button for a three-button mouse*/
  454. };
  456. typedef UInt16                          EventMouseButton;
  457. enum {
  458.     kEventMouseWheelDirectionUp = 0,
  459.     kEventMouseWheelDirectionDown = 1,
  460.     kEventMouseWheelDirectionLeft = 2,
  461.     kEventMouseWheelDirectionRight = 3
  462. };
  464. typedef UInt16                          EventMouseWheelDirection;
  465. /* Keyboard Events */
  466. enum {
  467.     kEventRawKeyDown            = 1,                            /* hardware-level events*/
  468.     kEventRawKeyRepeat          = 2,
  469.     kEventRawKeyUp              = 3,
  470.     kEventRawKeyModifiersChanged = 4
  471. };
  473. enum {
  474.     kEventTextInput             = 5                             /* high-level keyboard event (not available yet)*/
  475. };
  477. /* Application Events */
  478. enum {
  479.     kEventAppActivated          = 1,                            /* resume, in old parlance*/
  480.     kEventAppDeactivated        = 2,                            /* suspend, in old parlance*/
  481.     kEventAppQuit               = 3,                            /* this app is quitting.*/
  482.     kEventAppLaunchNotification = 4                             /* response to async application launch.*/
  483. };
  485. /* Apple Events */
  486. enum {
  487.     kEventHighLevelEvent        = 1
  488. };
  491. /*
  492.     Window Refresh Events
  493.     
  494.     o kEventWindowUpdate
  495.         low-level update event.  You must call BeginUpdate, call SetPort,
  496.         draw your window content, and then call EndUpdate.
  497.     
  498.     o kEventWindowDrawContent
  499.         sent when the standard window handler sees an update event. 
  500.         BeginUpdate, SetPort, and EndUpdate are called for you; all you do
  501.         is draw.
  502.     
  503.     o kEventWindowDrawStructure
  504.         sent after the window manager has drawn the window frame.  The
  505.         current port is a global port clipped to the window structure
  506.         region, not the window's port.
  507.         
  508.     o kEventWindowEraseContent
  509.         called when the window manager wishes to erase the window
  510.         background (In ShowWindow, for example).  The current port is set
  511.         to the window's port.
  512.         
  513.     o kEventWindowActivate
  514.         window is active now
  515.         
  516.     o kEventWindowDeactivate
  517.         window is inactive now
  518. */
  519. enum {
  520.     kEventWindowUpdate          = 1,
  521.     kEventWindowDrawContent     = 2,
  522.     kEventWindowDrawStructure   = 3,
  523.     kEventWindowEraseContent    = 4,
  524.     kEventWindowActivate        = 5,
  525.     kEventWindowDeactivate      = 6
  526. };
  528. /*
  529.     Window State Change Events
  530.     
  531.     o kEventWindowZOrderChanged
  532.         Sent after the window has changed position relative
  533.         to other windows in the application window list.
  534.     
  535.     o kEventWindowActivationChanged
  536.         Sent after the window has changed activation state
  537.     
  538.     o kEventWindowOriginChange
  539.       kEventWindowSizeChange
  540.         Sent during ResizeWindow/DragWindow, before the window is
  541.         actually modified.  Alter the current bounds in the event to
  542.         change the intended location of the window.  "Origin"
  543.         indicates that the window's place location onscreen is
  544.         different.  "Size" indicates that the window's size has
  545.         changed (the origin may also be different).
  546.     
  547.     o kEventWindowOriginChanged
  548.       kEventWindowSizeChanged
  549.         Sent after the window has been resized or moved.
  550. */
  552. enum {
  553.     kEventWindowZOrderChanged   = 16,
  554.     kEventWindowActivationChanged = 18,
  555.     kEventWindowOriginChange    = 20,
  556.     kEventWindowOriginChanged   = 21,
  557.     kEventWindowSizeChange      = 22,
  558.     kEventWindowSizeChanged     = 23
  559. };
  561. /*
  562.     Window Click Events
  563.     
  564.     Low-level events which generate higher-level "action" events.
  565.     Most clients should allow the standard window handler to implement
  566.     these events.
  567.     
  568.     o kEventWindowClickDragRgn
  569.         sent when the mouse is down in the drag region.  Calls DragWindow.
  570.     
  571.     o kEventWindowClickResizeRgn
  572.         sent when the mouse is down in the resize area.  Calls ResizeWindow.
  573.     
  574.     o kEventWindowClickCollapseRgn
  575.         sent when the mouse is down in the collapse widget.  Generates
  576.         kEventWindowExpand or kEventWindowCollapse (whichever is the opposite
  577.         of the window's current collapse state).
  578.     
  579.     o kEventWindowClickCloseRgn
  580.         sent when the mouse is down in the close widget.  Generates
  581.         kEventWindowClose.
  582.     
  583.     o kEventWindowClickZoomRgn
  584.         sent when the mouse is down in the zoom widget.  Generates
  585.         kEventWindowZoom.   
  586.         
  587.     o kEventWindowClickContentRgn
  588.         sent when the mouse is down in the content region.
  589.     
  590.     o kEventWindowClickProxyIconRgn
  591.         sent when the mouse is down in the proxy icon.  Generates proxy
  592.         icon events.
  593. */
  594. enum {
  595.     kEventWindowClickDragRgn    = 32,
  596.     kEventWindowClickResizeRgn  = 33,
  597.     kEventWindowClickCollapseRgn = 34,
  598.     kEventWindowClickCloseRgn   = 35,
  599.     kEventWindowClickZoomRgn    = 36,
  600.     kEventWindowClickContentRgn = 37,
  601.     kEventWindowClickProxyIconRgn = 38
  602. };
  604. /*
  605.     Window Action Events
  606.     
  607.     o kEventWindowCollapse
  608.         If the window is not collapsed, this event is sent by the standard
  609.         window handler after it has received kEventWindowClickCollapseRgn
  610.         and received true from a call to TrackBox.  Standard window handler
  611.         calls CollapseWindow and then sends kEventWindowCollapsed if no
  612.         error is received from CollapseWindow.
  613.     
  614.     o kEventWindowCollapsed
  615.         Notification that the object has successfully collapsed.
  616.     
  617.     o kEventWindowCollapseAll
  618.         Sent by the standard window handler (when the option key is down)
  619.         after it has received kEventWindowClickCollapseRgn and then
  620.         received true from a call to TrackBox.  The standard window
  621.         handler's response is to send each window of the same class as the
  622.         clicked window a kEventWindowCollapse event.
  623.     
  624.     o kEventWindowExpand
  625.         If the window is collapsed, this event is sent by the standard
  626.         window handler after it has received kEventWindowClickCollapseRgn
  627.         and received true from a call to TrackBox.  The standard window
  628.         handler's response is to call CollapseWindow, then send
  629.         kEventWindowExpanded.
  630.     
  631.     o kEventWindowExpanded
  632.         Sent by the standard window handler (when the option key is down)
  633.         after it has received kEventWindowClickCollapseRgn and then
  634.         received true from a call to TrackBox.  The standard window
  635.         handler's response is to send each window of the same class as the
  636.         clicked window a kEventWindowExpand event.
  637.     
  638.     o kEventWindowExpandAll
  639.         Notification that the window has successfully expanded.
  640.     
  641.     o kEventWindowClose
  642.         Sent by the standard window handler after it has received
  643.         kEventWindowClickCloseRgn and successfully called TrackBox.
  644.     
  645.     o kEventWindowClosed
  646.         Dispatched by DisposeWindow before the object is disposed.
  647.     
  648.     o kEventWindowCloseAll
  649.         Sent by the standard window handler (when the option key is down)
  650.         after it has received kEventWindowClickCloseRgn and received true
  651.         from a call to TrackGoAway.  The standard window handler's response
  652.         is to send each window with the same class as the clicked window a
  653.         kEventWindowClose event.
  654.     
  655.     o kEventWindowZoom
  656.         Sent by the standard window handler upon receiving
  657.         kEventWindowClickZoomRgn and then receiving true from a call to
  658.         TrackBox.  The standard window handler's response is to zoom the
  659.         window using the sample code taken from the 8.5 Window Manager
  660.         documentation. Upon successful zoom, kEventWindowZoomed is sent.
  661.     
  662.     o kEventWindowZoomed
  663.         Notification that object has been successfully zoomed.
  664.     
  665.     o kEventWindowZoomAll
  666.         Sent by the standard window handler (when the option key is down)
  667.         after it has received kEventObjectClickZoomRgn and received true
  668.         from a call to TrackBox.  The standard window handler's response is
  669.         to send each window with the same class as the clicked window a
  670.         kEventObjectZoom event and then to reposition all zoomed windows
  671.         using the kWindowCascadeOnParentWindowScreen positioning method.
  672.     
  673.     o kEventWindowContextualMenuSelect
  674.         Sent when either the right mouse button is pressed, or the control
  675.         key is held down and the left mouse button is pressed, or the left
  676.         mouse button is held down for more than 1/4th of a second (and
  677.         nothing else is handling the generated mouse tracking events).  
  678.         The standard window handler ignores this event.
  679.     
  680.     o kEventWindowPathSelect
  681.         Sent when IsWindowPathSelectClick would return true.  Set the
  682.         MenuRef in the event if you wish to customize the menu passed to
  683.         WindowPathSelect.
  684.     
  685.     o kEventWindowGetIdealSize
  686.         Sent by the standard window handler to determine the standard state
  687.         for zooming.
  688.     o kEventWindowGetMinimumSize
  689.         Sent by the standard window handler to determine the minimum size
  690.         of the window (used during window resizing).
  691.     
  692.     o kEventWindowProxyBeginDrag
  693.         Sent before a proxy icon drag; you can attach data to the DragRef
  694.         in the event.
  695.     
  696.     o kEventWindowProxyEndDrag
  697.         Sent after the proxy icon drag is complete, whether successful or
  698.         not.
  699. */
  700. enum {
  701.     kEventWindowCollapse        = 66,
  702.     kEventWindowCollapsed       = 67,
  703.     kEventWindowCollapseAll     = 68,
  704.     kEventWindowExpand          = 69,
  705.     kEventWindowExpanded        = 70,
  706.     kEventWindowExpandAll       = 71,
  707.     kEventWindowClose           = 72,
  708.     kEventWindowClosed          = 73,
  709.     kEventWindowCloseAll        = 74,
  710.     kEventWindowZoom            = 75,
  711.     kEventWindowZoomed          = 76,
  712.     kEventWindowZoomAll         = 77,
  713.     kEventWindowContextualMenuSelect = 78,
  714.     kEventWindowPathSelect      = 79,
  715.     kEventWindowGetIdealSize    = 80,
  716.     kEventWindowGetMinimumSize  = 81,
  717.     kEventWindowProxyBeginDrag  = 128,
  718.     kEventWindowProxyEndDrag    = 129
  719. };
  721. /* Menu Events */
  722. enum {
  723.     kEventMenuBeginTracking     = 1,
  724.     kEventMenuEndTracking       = 2,
  725.     kEventMenuChangeTrackingMode = 3,
  726.     kEventMenuOpening           = 4,
  727.     kEventMenuClosed            = 5,
  728.     kEventMenuTargetItem        = 6,
  729.     kEventMenuMatchKey          = 7
  730. };
  732. /* Command-related events */
  733. enum {
  734.     kEventProcessCommand        = 1
  735. };
  738. /* Control Events */
  739. enum {
  740.     kEventControlHit            = 1,
  741.     kEventControlSimulateHit    = 2
  742. };
  744. /* HI Commands */
  745. enum {
  746.     kHICommandCancel            = FOUR_CHAR_CODE('not!'),       /* the most important command: cancel the current operation!  sent when the user presses command-period*/
  747.     kHICommandQuit              = FOUR_CHAR_CODE('quit'),
  748.     kHICommandUndo              = FOUR_CHAR_CODE('undo'),
  749.     kHICommandRedo              = FOUR_CHAR_CODE('redo'),
  750.     kHICommandCut               = FOUR_CHAR_CODE('cut '),
  751.     kHICommandCopy              = FOUR_CHAR_CODE('copy'),
  752.     kHICommandPaste             = FOUR_CHAR_CODE('past'),
  753.     kHICommandClear             = FOUR_CHAR_CODE('clea'),
  754.     kHICommandSelectAll         = FOUR_CHAR_CODE('sall')
  755. };
  757. enum {
  758.     kHICommandFromMenu          = (1L << 0)
  759. };
  762. struct HICommand {
  763.     UInt32                          attributes;
  764.     UInt32                          commandID;
  765.     struct {
  766.         MenuRef                         menuRef;
  767.         UInt16                          menuItemIndex;
  768.     }                                 menu;
  769. };
  770. typedef struct HICommand                HICommand;
  771. /*--------------------------------------------------------------------------------------*/
  772. /* Mouse Events                                                                         */
  773. /*--------------------------------------------------------------------------------------*/
  775. EXTERN_API( OSStatus )
  776. CreateMouseEvent                (UInt32                 kind,
  777.                                  EventTime              when,
  778.                                  Point                  where,
  779.                                  UInt32                 modifiers,
  780.                                  EventRef *             outEvent);
  782. EXTERN_API( OSStatus )
  783. SetMouseEventMouseLocation      (EventRef               inEvent,
  784.                                  Point                  inPoint);
  786. EXTERN_API( OSStatus )
  787. SetMouseEventKeyModifiers       (EventRef               inEvent,
  788.                                  UInt32                 inModifiers);
  790. EXTERN_API( OSStatus )
  791. SetMouseEventClickCount         (EventRef               inEvent,
  792.                                  UInt32                 inCount);
  794. EXTERN_API( OSStatus )
  795. GetMouseEventMouseLocation      (EventRef               inEvent,
  796.                                  Point *                outPoint);
  798. EXTERN_API( OSStatus )
  799. GetMouseEventKeyModifiers       (EventRef               inEvent,
  800.                                  UInt32 *               outModifiers);
  802. EXTERN_API( OSStatus )
  803. GetMouseEventClickCount         (EventRef               inEvent,
  804.                                  UInt32 *               outCount);
  807. /*--------------------------------------------------------------------------------------*/
  808. /* Keyboard Events                                                                      */
  809. /*--------------------------------------------------------------------------------------*/
  811. EXTERN_API( OSStatus )
  812. CreateKeyboardEvent             (UInt32                 kind,
  813.                                  EventTime              when,
  814.                                  UInt32                 inKeyChar,
  815.                                  UInt32                 inKeyCode,
  816.                                  UInt32                 inKeyModifiers,
  817.                                  EventRef *             outEvent);
  819. EXTERN_API( OSStatus )
  820. SetKeyboardEventKeyCode         (EventRef               inEvent,
  821.                                  UInt32                 inKeyCode);
  823. EXTERN_API( OSStatus )
  824. SetKeyboardEventKeyChar         (EventRef               inEvent,
  825.                                  UInt32                 inKeyChar);
  827. EXTERN_API( OSStatus )
  828. SetKeyboardEventKeyModifiers    (EventRef               inEvent,
  829.                                  UInt32                 inModifiers);
  831. EXTERN_API( OSStatus )
  832. GetKeyboardEventKeyCode         (EventRef               inEvent,
  833.                                  UInt32 *               outKeyCode);
  835. EXTERN_API( OSStatus )
  836. GetKeyboardEventKeyChar         (EventRef               inEvent,
  837.                                  UInt32 *               outKeyChar);
  839. EXTERN_API( OSStatus )
  840. GetKeyboardEventKeyModifiers    (EventRef               inEvent,
  841.                                  UInt32 *               outModifiers);
  843. /*--------------------------------------------------------------------------------------*/
  844. /* Window Events                                                                        */
  845. /*--------------------------------------------------------------------------------------*/
  846. EXTERN_API( OSStatus )
  847. CreateWindowEvent               (UInt32                 kind,
  848.                                  EventTime              when,
  849.                                  WindowRef              window,
  850.                                  EventRef *             outEvent);
  852. EXTERN_API( OSStatus )
  853. SetWindowEventWindowRef         (EventRef               inEvent,
  854.                                  WindowRef              inWindow);
  856. EXTERN_API( OSStatus )
  857. SetWindowEventKeyModifiers      (EventRef               inEvent,
  858.                                  UInt32                 inModifiers);
  860. EXTERN_API( OSStatus )
  861. SetWindowEventMouseLocation     (EventRef               inEvent,
  862.                                  Point                  inWhere);
  864. EXTERN_API( OSStatus )
  865. SetWindowEventWindowSize        (EventRef               inEvent,
  866.                                  Point                  inSize);
  868. EXTERN_API( OSStatus )
  869. GetWindowEventWindowRef         (EventRef               inEvent,
  870.                                  WindowRef *            outWindow);
  872. EXTERN_API( OSStatus )
  873. GetWindowEventKeyModifiers      (EventRef               inEvent,
  874.                                  UInt32 *               outModifiers);
  876. EXTERN_API( OSStatus )
  877. GetWindowEventMouseLocation     (EventRef               inEvent,
  878.                                  Point *                outWhere);
  880. EXTERN_API( OSStatus )
  881. GetWindowEventWindowSize        (EventRef               inEvent,
  882.                                  Point *                outSize);
  884. /* window proxy events contain dragrefs*/
  885. EXTERN_API( OSStatus )
  886. GetWindowEventDragRef           (EventRef               eventRef,
  887.                                  DragRef *              outDrag);
  889. EXTERN_API( OSStatus )
  890. SetWindowEventDragRef           (EventRef               eventRef,
  891.                                  DragRef                inDrag);
  893. EXTERN_API( OSStatus )
  894. GetWindowEventMenuRef           (EventRef               eventRef,
  895.                                  MenuRef *              outMenu);
  897. EXTERN_API( OSStatus )
  898. SetWindowEventMenuRef           (EventRef               eventRef,
  899.                                  MenuRef                inMenu);
  901. /* window bounds-changed events*/
  902. EXTERN_API( OSStatus )
  903. GetWindowEventOriginalBounds    (EventRef               eventRef,
  904.                                  Rect *                 outBounds);
  906. EXTERN_API( OSStatus )
  907. SetWindowEventOriginalBounds    (EventRef               eventRef,
  908.                                  const Rect *           inBounds);
  910. EXTERN_API( OSStatus )
  911. GetWindowEventPreviousBounds    (EventRef               eventRef,
  912.                                  Rect *                 outBounds);
  914. EXTERN_API( OSStatus )
  915. SetWindowEventPreviousBounds    (EventRef               eventRef,
  916.                                  const Rect *           inBounds);
  918. EXTERN_API( OSStatus )
  919. GetWindowEventCurrentBounds     (EventRef               eventRef,
  920.                                  Rect *                 outBounds);
  922. EXTERN_API( OSStatus )
  923. SetWindowEventCurrentBounds     (EventRef               eventRef,
  924.                                  const Rect *           inBounds);
  926. EXTERN_API( OSStatus )
  927. GetWindowEventGrafPort          (EventRef               eventRef,
  928.                                  GrafPtr *              outPort);
  930. EXTERN_API( OSStatus )
  931. SetWindowEventGrafPort          (EventRef               eventRef,
  932.                                  GrafPtr                inPort);
  934. /* window click events each contain a reference to the original mouse down event*/
  935. EXTERN_API( OSStatus )
  936. GetWindowEventMouseEvent        (EventRef               eventRef,
  937.                                  EventRef *             outEvent);
  939. EXTERN_API( OSStatus )
  940. SetWindowEventMouseEvent        (EventRef               eventRef,
  941.                                  EventRef               inEvent);
  944. /*--------------------------------------------------------------------------------------*/
  945. /* Control Events                                                                       */
  946. /*--------------------------------------------------------------------------------------*/
  947. EXTERN_API( OSStatus )
  948. CreateControlEvent              (UInt32                 kind,
  949.                                  EventTime              when,
  950.                                  ControlRef             control,
  951.                                  EventRef *             outEvent);
  953. EXTERN_API( OSStatus )
  954. SetControlEventControlRef       (EventRef               inEvent,
  955.                                  ControlRef             inControl);
  957. EXTERN_API( OSStatus )
  958. SetControlEventControlPartCode  (EventRef               inEvent,
  959.                                  ControlPartCode        inPart);
  961. EXTERN_API( OSStatus )
  962. SetControlEventKeyModifiers     (EventRef               inEvent,
  963.                                  UInt32                 inModifiers);
  965. EXTERN_API( OSStatus )
  966. GetControlEventControlRef       (EventRef               inEvent,
  967.                                  ControlRef *           outControl);
  969. EXTERN_API( OSStatus )
  970. GetControlEventControlPartCode  (EventRef               inEvent,
  971.                                  ControlPartCode *      outPart);
  973. EXTERN_API( OSStatus )
  974. GetControlEventKeyModifiers     (EventRef               inEvent,
  975.                                  UInt32 *               outModifiers);
  977. /*--------------------------------------------------------------------------------------*/
  978. /* Menu Events                                                                          */
  979. /*--------------------------------------------------------------------------------------*/
  980. EXTERN_API( OSStatus )
  981. CreateMenuEvent                 (UInt32                 kind,
  982.                                  EventTime              when,
  983.                                  MenuRef                menu,
  984.                                  EventRef *             outEvent);
  986. EXTERN_API( OSStatus )
  987. SetMenuEventMenuRef             (EventRef               inEvent,
  988.                                  MenuRef                inMenu);
  990. EXTERN_API( OSStatus )
  991. SetMenuEventTrackingMode        (EventRef               inEvent,
  992.                                  MenuTrackingMode       inMode,
  993.                                  Boolean                setCurrent);
  995. EXTERN_API( OSStatus )
  996. SetMenuEventFirstTimeOpen       (EventRef               inEvent,
  997.                                  Boolean                inFirstTimeOpen);
  999. EXTERN_API( OSStatus )
  1000. SetMenuEventItemIndex           (EventRef               inEvent,
  1001.                                  MenuItemIndex          inItemIndex);
  1003. EXTERN_API( OSStatus )
  1004. SetMenuEventCommandID           (EventRef               inEvent,
  1005.                                  MenuCommand            inCommand);
  1007. EXTERN_API( OSStatus )
  1008. SetMenuEventKeyEvent            (EventRef               inEvent,
  1009.                                  EventRef               inKeyEvent);
  1011. EXTERN_API( OSStatus )
  1012. SetMenuEventHICommand           (EventRef               inEvent,
  1013.                                  const HICommand *      inCommand);
  1015. EXTERN_API( OSStatus )
  1016. GetMenuEventMenuRef             (EventRef               inEvent,
  1017.                                  MenuRef *              outMenu);
  1019. EXTERN_API( OSStatus )
  1020. GetMenuEventTrackingMode        (EventRef               inEvent,
  1021.                                  Boolean                getCurrent,
  1022.                                  MenuTrackingMode *     outMode);
  1024. EXTERN_API( OSStatus )
  1025. GetMenuEventFirstTimeOpen       (EventRef               inEvent,
  1026.                                  Boolean *              outFirstTimeOpen);
  1028. EXTERN_API( OSStatus )
  1029. GetMenuEventItemIndex           (EventRef               inEvent,
  1030.                                  MenuItemIndex *        outItemIndex);
  1032. EXTERN_API( OSStatus )
  1033. GetMenuEventCommandID           (EventRef               inEvent,
  1034.                                  MenuCommand *          outCommand);
  1036. EXTERN_API( OSStatus )
  1037. GetMenuEventKeyEvent            (EventRef               inEvent,
  1038.                                  EventRef *             outKeyEvent);
  1040. EXTERN_API( OSStatus )
  1041. GetMenuEventHICommand           (EventRef               inEvent,
  1042.                                  HICommand *            outCommand);
  1044. /*--------------------------------------------------------------------------------------*/
  1045. /* Command Events                                                                       */
  1046. /*--------------------------------------------------------------------------------------*/
  1048. EXTERN_API( OSStatus )
  1049. CreateCommandEvent              (UInt32                 kind,
  1050.                                  EventTime              when,
  1051.                                  const HICommand *      inCommand,
  1052.                                  EventRef *             outEvent);
  1054. EXTERN_API( OSStatus )
  1055. GetCommandEventCommand          (EventRef               inEvent,
  1056.                                  HICommand *            outCommand);
  1058. /*--------------------------------------------------------------------------------------*/
  1059. /* Miscellany                                                                           */
  1060. /*--------------------------------------------------------------------------------------*/
  1062. EXTERN_API( OSStatus )
  1063. CreateApplicationEvent          (UInt32                 kind,
  1064.                                  EventTime              when,
  1065.                                  EventRef *             outEvent);
  1068. /*
  1069.    This routine is used to get information about an async application launch
  1070.    It is only valid on Mac OS X.
  1071. */
  1073. EXTERN_API( OSStatus )
  1074. GetApplicationEventLaunchData   (EventRef               event,
  1075.                                  OSStatus *             outLaunchErr,
  1076.                                  ProcessSerialNumber *  outProcess,
  1077.                                  void **                outLaunchRefCon);
  1079. /*======================================================================================*/
  1080. /*  EVENT HANDLERS                                                                      */
  1081. /*======================================================================================*/
  1083. typedef UInt32 EventHandlerResult;
  1084. enum {
  1085.     kEventHandlerHandled        = 0,
  1086.     kEventHandlerNotHandled     = 1,
  1087.     kEventHandlerPassUpChain    = 2,
  1088.     kEventHandlerStopProcessing = 3
  1089. };
  1092. enum {
  1093.     kEventHandlerStandard       = -1L
  1094. };
  1099. typedef struct OpaqueEventHandlerRef*   EventHandlerRef;
  1101. /*--------------------------------------------------------------------------------------*/
  1102. /*  o EventHandler specification                                                        */
  1103. /*--------------------------------------------------------------------------------------*/
  1105. typedef CALLBACK_API( EventHandlerResult , EventHandlerProcPtr )(EventHandlerRef inHandlerRef, EventRef inEvent, void *userData);
  1106. typedef STACK_UPP_TYPE(EventHandlerProcPtr)                     EventHandlerUPP;
  1107. #if OPAQUE_UPP_TYPES
  1108.     EXTERN_API(EventHandlerUPP)
  1109.     NewEventHandlerUPP             (EventHandlerProcPtr     userRoutine);
  1111.     EXTERN_API(void)
  1112.     DisposeEventHandlerUPP         (EventHandlerUPP         userUPP);
  1114.     EXTERN_API(EventHandlerResult)
  1115.     InvokeEventHandlerUPP          (EventHandlerRef         inHandlerRef,
  1116.                                     EventRef                inEvent,
  1117.                                     void *                  userData,
  1118.                                     EventHandlerUPP         userUPP);
  1120. #else
  1121.     enum { uppEventHandlerProcInfo = 0x00000FF0 };                  /* pascal 4_bytes Func(4_bytes, 4_bytes, 4_bytes) */
  1122.     #define NewEventHandlerUPP(userRoutine)                         (EventHandlerUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppEventHandlerProcInfo, GetCurrentArchitecture())
  1123.     #define DisposeEventHandlerUPP(userUPP)                         DisposeRoutineDescriptor(userUPP)
  1124.     #define InvokeEventHandlerUPP(inHandlerRef, inEvent, userData, userUPP)  (EventHandlerResult)CALL_THREE_PARAMETER_UPP((userUPP), uppEventHandlerProcInfo, (inHandlerRef), (inEvent), (userData))
  1125. #endif
  1126. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  1127. #define NewEventHandlerProc(userRoutine)                        NewEventHandlerUPP(userRoutine)
  1128. #define CallEventHandlerProc(userRoutine, inHandlerRef, inEvent, userData) InvokeEventHandlerUPP(inHandlerRef, inEvent, userData, userRoutine)
  1129. /*--------------------------------------------------------------------------------------*/
  1130. /*  o Installing Event Handlers                                                         */
  1131. /*                                                                                      */
  1132. /* Use these routines to install event handlers for a specific toolbox object. You may  */
  1133. /* pass zero for inNumTypes and NULL for inList if you need to be in a situation where  */
  1134. /* you know you will be receiving events, but not exactly which ones at the time you    */
  1135. /* are installing the handler. Later, your application can call the Add/Remove routines */
  1136. /* listed below this section.                                                           */
  1137. /*                                                                                      */
  1138. /* You can only install a specific handler once. The combination of inHandler and       */
  1139. /* inUserData is considered the 'signature' of a handler. Any attempt to install a new  */
  1140. /* handler with the same proc and user data as an already-installed handler will result */
  1141. /* in eventHandlerAlreadyInstalledErr. Installing the same proc and user data on a      */
  1142. /* different object is legal.                                                           */
  1143. /*                                                                                      */
  1144. /* Upon successful completion of this routine, you are returned an EventHandlerRef,     */
  1145. /* which you can use in various other calls, and is passed to your event handler. You   */
  1146. /* use it to extract information about the handler, such as the target (window, etc.)   */
  1147. /* if you have the same handler installed for different objects and need to perform     */
  1148. /* actions on the current target (say, call a window manager function).                 */
  1149. /*--------------------------------------------------------------------------------------*/
  1150. EXTERN_API( OSStatus )
  1151. InstallApplicationEventHandler  (EventHandlerUPP        inHandler,
  1152.                                  UInt32                 inNumTypes,
  1153.                                  const EventTypeSpec *  inList,
  1154.                                  void *                 inUserData,
  1155.                                  EventHandlerRef *      outRef);
  1157. EXTERN_API( OSStatus )
  1158. InstallWindowEventHandler       (WindowRef              inWindowRef,
  1159.                                  EventHandlerUPP        inHandler,
  1160.                                  UInt32                 inNumTypes,
  1161.                                  const EventTypeSpec *  inList,
  1162.                                  void *                 inUserData,
  1163.                                  EventHandlerRef *      outRef);
  1165. EXTERN_API( OSStatus )
  1166. InstallControlEventHandler      (ControlRef             inControlRef,
  1167.                                  EventHandlerUPP        inHandler,
  1168.                                  UInt32                 inNumTypes,
  1169.                                  const EventTypeSpec *  inList,
  1170.                                  void *                 inUserData,
  1171.                                  EventHandlerRef *      outRef);
  1173. EXTERN_API( OSStatus )
  1174. InstallMenuEventHandler         (MenuRef                inMenuRef,
  1175.                                  EventHandlerUPP        inHandler,
  1176.                                  UInt32                 inNumTypes,
  1177.                                  const EventTypeSpec *  inList,
  1178.                                  void *                 inUserData,
  1179.                                  EventHandlerRef *      outRef);
  1181. EXTERN_API( OSStatus )
  1182. RemoveEventHandler              (EventHandlerRef        inHandlerRef);
  1184. /*--------------------------------------------------------------------------------------*/
  1185. /*  o Adjusting set of event types after a handler is created                           */
  1186. /*                                                                                      */
  1187. /* After installing a handler with the routine above, you can adjust the event type     */
  1188. /* list telling the toolbox what events to send to that handler by calling the two      */
  1189. /* routines below. If you add an event type twice for the same handler, your handler    */
  1190. /* will only be called once, but it will take two RemoveEventType calls to stop your    */
  1191. /* handler from being called with that event type. In other words, the install count    */
  1192. /* for each event type is maintained by the toolbox. This might allow you, for example  */
  1193. /* to have subclasses of a window object register for types without caring if the base  */
  1194. /* class has already registered for that type. When the subclass removes its types, it  */
  1195. /* can succesfully do so without affecting the base class' reception of its events      */
  1196. /* types, yielding eternal bliss.                                                       */
  1197. /*--------------------------------------------------------------------------------------*/
  1199. EXTERN_API( OSStatus )
  1200. AddEventTypesToHandler          (EventHandlerRef        inHandlerRef,
  1201.                                  UInt32                 inNumTypes,
  1202.                                  const EventTypeSpec *  inList);
  1204. EXTERN_API( OSStatus )
  1205. RemoveEventTypesFromHandler     (EventHandlerRef        inHandlerRef,
  1206.                                  UInt32                 inNumTypes,
  1207.                                  const EventTypeSpec *  inList);
  1209. /*--------------------------------------------------------------------------------------*/
  1210. /*  o Explicit Propogation                                                              */
  1211. /*--------------------------------------------------------------------------------------*/
  1213. EXTERN_API( EventHandlerResult )
  1214. CallNextEventHandler            (EventHandlerRef        inThisHandler,
  1215.                                  EventRef               inEvent);
  1217. /*--------------------------------------------------------------------------------------*/
  1218. /*  o Getting the target from a handler ref                                             */
  1219. /*--------------------------------------------------------------------------------------*/
  1221. EXTERN_API( ControlRef )
  1222. GetEventHandlerTargetControl    (EventHandlerRef        inHandler);
  1224. EXTERN_API( WindowRef )
  1225. GetEventHandlerTargetWindow     (EventHandlerRef        inHandler);
  1227. EXTERN_API( MenuRef )
  1228. GetEventHandlerTargetMenu       (EventHandlerRef        inHandler);
  1230. /*--------------------------------------------------------------------------------------*/
  1231. /*  o Sending Events                                                                    */
  1232. /*--------------------------------------------------------------------------------------*/
  1234. EXTERN_API( EventHandlerResult )
  1235. SendEventToApplication          (EventRef               inEvent);
  1237. EXTERN_API( EventHandlerResult )
  1238. SendEventToWindow               (EventRef               inEvent,
  1239.                                  WindowRef              inWindow);
  1241. EXTERN_API( EventHandlerResult )
  1242. SendEventToControl              (EventRef               inEvent,
  1243.                                  ControlRef             inControl);
  1245. EXTERN_API( EventHandlerResult )
  1246. SendEventToMenu                 (EventRef               inEvent,
  1247.                                  MenuRef                inMenu);
  1249. EXTERN_API( EventHandlerResult )
  1250. SendEventToUserFocus            (EventRef               inEvent);
  1252. /*--------------------------------------------------------------------------------------*/
  1253. /*  o Command Routines                                                                  */
  1254. /*--------------------------------------------------------------------------------------*/
  1256. EXTERN_API( EventHandlerResult )
  1257. ProcessHICommand                (const HICommand *      inCommand);
  1259. /*--------------------------------------------------------------------------------------*/
  1260. /*  o Event Loop Routines                                                               */
  1261. /*--------------------------------------------------------------------------------------*/
  1263. EXTERN_API( void )
  1264. RunApplicationEventLoop         (void);
  1266. EXTERN_API( void )
  1267. QuitApplicationEventLoop        (void);
  1269. /*--------------------------------------------------------------------------------------*/
  1270. /*  o User Focus                                                                        */
  1271. /*--------------------------------------------------------------------------------------*/
  1273. EXTERN_API( void )
  1274. SetUserFocusWindow              (WindowRef              inWindow);
  1276. EXTERN_API( WindowRef )
  1277. GetUserFocusWindow              (void);
  1280. /*--------------------------------------------------------------------------------------*/
  1281. /*  o Default/Cancel buttons                                                            */
  1282. /*--------------------------------------------------------------------------------------*/
  1284. EXTERN_API( OSStatus )
  1285. SetWindowDefaultButton          (WindowRef              inWindow,
  1286.                                  ControlRef             inControl) /* can be NULL */;
  1288. EXTERN_API( OSStatus )
  1289. SetWindowCancelButton           (WindowRef              inWindow,
  1290.                                  ControlRef             inControl) /* can be NULL */;
  1292. EXTERN_API( OSStatus )
  1293. GetWindowDefaultButton          (WindowRef              inWindow,
  1294.                                  ControlRef *           outControl);
  1296. EXTERN_API( OSStatus )
  1297. GetWindowCancelButton           (WindowRef              inWindow,
  1298.                                  ControlRef *           outControl);
  1301. /*--------------------------------------------------------------------------------------*/
  1302. /*  o Mouse Tracking Areas                                                              */
  1303. /*                                                                                      */
  1304. /*  Mouse tracking areas control the generation of mouse-enter and                      */
  1305. /*  mouse-exit events.  When the user moves the mouse into a tracking                   */
  1306. /*  area, kEventMouseEnter is sent to the window.  When the user moves                  */
  1307. /*  the mouse out of a tracking area, kEventMouseExit is sent.                          */
  1308. /*                                                                                      */
  1309. /*  Mouse tracking regions are uniquely identified within the scope of                  */
  1310. /*  a window by a client signature/MouseTrackingRef pair.  The client                   */
  1311. /*  signature is the usual DTS-registered creator OSType.                               */
  1312. /*                                                                                      */
  1313. /*  Mouse tracking areas can overlap, but are not exclusive.  Mouse                     */
  1314. /*  motion events are generated for each of the tracking areas                          */
  1315. /*  intersected by the mouse.                                                           */
  1316. /*                                                                                      */
  1317. /*  Mouse tracking areas are initially enabled.  You can explicitly                     */
  1318. /*  disable a mouse tracking area to prevent mouse-enter/exit events                    */
  1319. /*  from being generated.                                                               */
  1320. /*                                                                                      */
  1321. /*  Unlike global mouse-moved events, mouse-enter and mouse-exit are                    */
  1322. /*  generated while your app is in the background.  If this is not                      */
  1323. /*  considered desirable, disable the tracking areas while the                          */
  1324. /*  application is in the background.                                                   */
  1325. /*--------------------------------------------------------------------------------------*/
  1326. typedef struct OpaqueMouseTrackingRef*  MouseTrackingRef;
  1327. /*
  1328.     Tracking Options
  1329.     If locally clipped, the region is expected in local coordinates and
  1330.     mouse movement tracking is clipped to the window's content region.
  1331.     If globally clipped, the region is expected in global coordinates and
  1332.     the tracking area is clipped to  window's structure region.
  1333. */
  1335. typedef OptionBits                      MouseTrackingOptions;
  1336. enum {
  1337.     kMouseTrackingOptionLocalClip = 0,                          /* specify a region in local coordinates; it will be clipped to the window's content region*/
  1338.     kMouseTrackingOptionGlobalClip = 1,                         /* specify a region in global coordinates; it will be clipped to the window's structure region*/
  1339.     kMouseTrackingOptionsStandard = kMouseTrackingOptionLocalClip
  1340. };
  1342. /* Creation*/
  1343. EXTERN_API( OSStatus )
  1344. CreateMouseTrackingArea         (WindowRef              inWindow,
  1345.                                  OSType                 inCreator,
  1346.                                  MouseTrackingOptions   inOptions,
  1347.                                  RgnHandle              inRegion,
  1348.                                  MouseTrackingRef *     outMouseRef);
  1350. EXTERN_API( OSStatus )
  1351. RetainMouseTrackingArea         (MouseTrackingRef       inMouseRef);
  1353. EXTERN_API( OSStatus )
  1354. ReleaseMouseTrackingArea        (MouseTrackingRef       inMouseRef);
  1356. /* Accessors*/
  1357. EXTERN_API( OSStatus )
  1358. SetMouseTrackingAreaRefCon      (MouseTrackingRef       inMouseRef,
  1359.                                  UInt32                 refCon);
  1361. EXTERN_API( OSStatus )
  1362. GetMouseTrackingAreaRefCon      (MouseTrackingRef       inMouseRef,
  1363.                                  UInt32 *               outRefCon);
  1365. /* Geometry*/
  1366. EXTERN_API( OSStatus )
  1367. MoveMouseTrackingArea           (MouseTrackingRef       inMouseRef,
  1368.                                  SInt16                 deltaH,
  1369.                                  SInt16                 deltaV);
  1371. EXTERN_API( OSStatus )
  1372. SetMouseTrackingAreaRegion      (MouseTrackingRef       inMouseRef,
  1373.                                  RgnHandle              inRegion);
  1375. EXTERN_API( OSStatus )
  1376. GetMouseTrackingAreaRegion      (MouseTrackingRef       inMouseRef,
  1377.                                  RgnHandle              outRgn);
  1379. /* Enable/disable*/
  1380. EXTERN_API( OSStatus )
  1381. SetMouseTrackingAreaEnabled     (MouseTrackingRef       inMouseRef,
  1382.                                  Boolean                enabled);
  1384. /* Namespace-scoped operations*/
  1385. EXTERN_API( OSStatus )
  1386. ReleaseWindowMouseTrackingAreas (WindowRef              inWindow,
  1387.                                  OSType                 creator);
  1389. EXTERN_API( OSStatus )
  1390. MoveWindowMouseTrackingAreas    (WindowRef              inWindow,
  1391.                                  OSType                 creator,
  1392.                                  SInt16                 deltaH,
  1393.                                  SInt16                 deltaV);
  1395. EXTERN_API( OSStatus )
  1396. SetWindowMouseTrackingAreasEnabled (WindowRef           inWindow,
  1397.                                  OSType                 creator,
  1398.                                  Boolean                enabled);
  1400. /* Mouse event accessor additions*/
  1402. /* Mouse-enter and exit events contain the tracking ref for which they are generated.*/
  1403. EXTERN_API( OSStatus )
  1404. SetMouseEventTrackingArea       (EventRef               inEvent,
  1405.                                  MouseTrackingRef       inMouseRef);
  1407. EXTERN_API( OSStatus )
  1408. GetMouseEventTrackingArea       (EventRef               inEvent,
  1409.                                  MouseTrackingRef *     outMouseRef);
  1413. #if PRAGMA_STRUCT_ALIGN
  1414.     #pragma options align=reset
  1415. #elif PRAGMA_STRUCT_PACKPUSH
  1416.     #pragma pack(pop)
  1417. #elif PRAGMA_STRUCT_PACK
  1418.     #pragma pack()
  1419. #endif
  1421. #ifdef PRAGMA_IMPORT_OFF
  1422. #pragma import off
  1423. #elif PRAGMA_IMPORT
  1424. #pragma import reset
  1425. #endif
  1427. #ifdef __cplusplus
  1428. }
  1429. #endif
  1431. #endif /* __CARBONEVENTS__ */