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

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

多媒体编程

开发平台：

Visual C++

Controls.h：源码内容
  1. /*
  2.      File:       Controls.h
  3.  
  4.      Contains:   Control Manager interfaces
  5.  
  6.      Version:    Technology: Mac OS 9
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1985-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 __CONTROLS__
  18. #define __CONTROLS__
  20. #ifndef __MACTYPES__
  21. #include "MacTypes.h"
  22. #endif
  24. #ifndef __QUICKDRAW__
  25. #include "Quickdraw.h"
  26. #endif
  28. #ifndef __MENUS__
  29. #include "Menus.h"
  30. #endif
  32. #ifndef __TEXTEDIT__
  33. #include "TextEdit.h"
  34. #endif
  36. #ifndef __DRAG__
  37. #include "Drag.h"
  38. #endif
  40. #ifndef __ICONS__
  41. #include "Icons.h"
  42. #endif
  44. #ifndef __COLLECTIONS__
  45. #include "Collections.h"
  46. #endif
  48. #ifndef __MACERRORS__
  49. #include "MacErrors.h"
  50. #endif
  56. #if PRAGMA_ONCE
  57. #pragma once
  58. #endif
  60. #ifdef __cplusplus
  61. extern "C" {
  62. #endif
  64. #if PRAGMA_IMPORT
  65. #pragma import on
  66. #endif
  68. #if PRAGMA_STRUCT_ALIGN
  69.     #pragma options align=mac68k
  70. #elif PRAGMA_STRUCT_PACKPUSH
  71.     #pragma pack(push, 2)
  72. #elif PRAGMA_STRUCT_PACK
  73.     #pragma pack(2)
  74. #endif
  76. /*------------------------------------------------------------------------------------------------------*/
  77. /*  o Resource Types                                                                                    */
  78. /*------------------------------------------------------------------------------------------------------*/
  79. enum {
  80.     kControlDefProcType         = FOUR_CHAR_CODE('CDEF'),
  81.     kControlTemplateResourceType = FOUR_CHAR_CODE('CNTL'),
  82.     kControlColorTableResourceType = FOUR_CHAR_CODE('cctb'),
  83.     kControlDefProcResourceType = FOUR_CHAR_CODE('CDEF')
  84. };
  86. /*------------------------------------------------------------------------------------------------------*/
  87. /*  o Format of a 'CNTL' resource                                                                       */
  88. /*------------------------------------------------------------------------------------------------------*/
  90. struct ControlTemplate {
  91.     Rect                            controlRect;
  92.     SInt16                          controlValue;
  93.     Boolean                         controlVisible;
  94.     UInt8                           fill;
  95.     SInt16                          controlMaximum;
  96.     SInt16                          controlMinimum;
  97.     SInt16                          controlDefProcID;
  98.     SInt32                          controlReference;
  99.     Str255                          controlTitle;
  100. };
  101. typedef struct ControlTemplate          ControlTemplate;
  102. typedef ControlTemplate *               ControlTemplatePtr;
  103. typedef ControlTemplatePtr *            ControlTemplateHandle;
  106. #if !TARGET_OS_MAC
  107. /*
  108.   ---------------------------------------------------------------------------------------------------------
  109.    o NON-MAC COMPATIBILITY CODES (QuickTime 3.0)
  110.   ---------------------------------------------------------------------------------------------------------
  111. */
  113. typedef UInt32                          ControlNotification;
  114. enum {
  115.     controlNotifyNothing        = FOUR_CHAR_CODE('nada'),       /* No (null) notification*/
  116.     controlNotifyClick          = FOUR_CHAR_CODE('clik'),       /* Control was clicked*/
  117.     controlNotifyFocus          = FOUR_CHAR_CODE('focu'),       /* Control got keyboard focus*/
  118.     controlNotifyKey            = FOUR_CHAR_CODE('key ')        /* Control got a keypress*/
  119. };
  121. typedef UInt32                          ControlCapabilities;
  122. enum {
  123.     kControlCanAutoInvalidate   = 1L << 0                       /* Control component automatically invalidates areas left behind after hide/move operation.*/
  124. };
  126. /* procID's for our added "controls"*/
  127. enum {
  128.     staticTextProc              = 256,                          /* static text*/
  129.     editTextProc                = 272,                          /* editable text*/
  130.     iconProc                    = 288,                          /* icon*/
  131.     userItemProc                = 304,                          /* user drawn item*/
  132.     pictItemProc                = 320                           /* pict*/
  133. };
  135. #endif  /* !TARGET_OS_MAC */
  137. /*------------------------------------------------------------------------------------------------------*/
  138. /*  o ControlRef                                                                                        */
  139. /*------------------------------------------------------------------------------------------------------*/
  140. #if !OPAQUE_TOOLBOX_STRUCTS
  141. typedef struct ControlRecord            ControlRecord;
  142. typedef ControlRecord *                 ControlPtr;
  143. typedef ControlPtr *                    ControlRef;
  144. #else
  145. typedef struct OpaqueControlRef*        ControlRef;
  146. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  148. /* ControlHandle is obsolete. Use ControlRef.*/
  149. typedef ControlRef                      ControlHandle;
  150. typedef SInt16                          ControlPartCode;
  151. /*------------------------------------------------------------------------------------------------------*/
  152. /* o Control ActionProcPtr                                                                              */
  153. /*------------------------------------------------------------------------------------------------------*/
  154. typedef CALLBACK_API( void , ControlActionProcPtr )(ControlRef theControl, ControlPartCode partCode);
  155. typedef STACK_UPP_TYPE(ControlActionProcPtr)                    ControlActionUPP;
  156. /*------------------------------------------------------------------------------------------------------*/
  157. /*  o ControlRecord                                                                                     */
  158. /*------------------------------------------------------------------------------------------------------*/
  159. #if !OPAQUE_TOOLBOX_STRUCTS
  161. struct ControlRecord {
  162.     ControlRef                      nextControl;
  163.     WindowPtr                       contrlOwner;
  164.     Rect                            contrlRect;
  165.     UInt8                           contrlVis;
  166.     UInt8                           contrlHilite;
  167.     SInt16                          contrlValue;
  168.     SInt16                          contrlMin;
  169.     SInt16                          contrlMax;
  170.     Handle                          contrlDefProc;
  171.     Handle                          contrlData;
  172.     ControlActionUPP                contrlAction;
  173.     SInt32                          contrlRfCon;
  174.     Str255                          contrlTitle;
  175. };
  177. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  179. /*------------------------------------------------------------------------------------------------------*/
  180. /* o Control ActionProcPtr : Epilogue                                                                   */
  181. /*------------------------------------------------------------------------------------------------------*/
  182. #if OPAQUE_UPP_TYPES
  183.     EXTERN_API(ControlActionUPP)
  184.     NewControlActionUPP            (ControlActionProcPtr    userRoutine);
  186.     EXTERN_API(void)
  187.     DisposeControlActionUPP        (ControlActionUPP        userUPP);
  189.     EXTERN_API(void)
  190.     InvokeControlActionUPP         (ControlRef              theControl,
  191.                                     ControlPartCode         partCode,
  192.                                     ControlActionUPP        userUPP);
  194. #else
  195.     enum { uppControlActionProcInfo = 0x000002C0 };                 /* pascal no_return_value Func(4_bytes, 2_bytes) */
  196.     #define NewControlActionUPP(userRoutine)                        (ControlActionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppControlActionProcInfo, GetCurrentArchitecture())
  197.     #define DisposeControlActionUPP(userUPP)                        DisposeRoutineDescriptor(userUPP)
  198.     #define InvokeControlActionUPP(theControl, partCode, userUPP)   CALL_TWO_PARAMETER_UPP((userUPP), uppControlActionProcInfo, (theControl), (partCode))
  199. #endif
  200. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  201. #define NewControlActionProc(userRoutine)                       NewControlActionUPP(userRoutine)
  202. #define CallControlActionProc(userRoutine, theControl, partCode) InvokeControlActionUPP(theControl, partCode, userRoutine)
  203. /*------------------------------------------------------------------------------------------------------*/
  204. /*  o Control Color Table                                                                               */
  205. /*------------------------------------------------------------------------------------------------------*/
  206. enum {
  207.     cFrameColor                 = 0,
  208.     cBodyColor                  = 1,
  209.     cTextColor                  = 2,
  210.     cThumbColor                 = 3,
  211.     kNumberCtlCTabEntries       = 4
  212. };
  215. struct CtlCTab {
  216.     SInt32                          ccSeed;
  217.     SInt16                          ccRider;
  218.     SInt16                          ctSize;
  219.     ColorSpec                       ctTable[4];
  220. };
  221. typedef struct CtlCTab                  CtlCTab;
  223. typedef CtlCTab *                       CCTabPtr;
  224. typedef CCTabPtr *                      CCTabHandle;
  225. /*------------------------------------------------------------------------------------------------------*/
  226. /*  o Auxiliary Control Record                                                                          */
  227. /*------------------------------------------------------------------------------------------------------*/
  228. #if !OPAQUE_TOOLBOX_STRUCTS
  230. struct AuxCtlRec {
  231.     Handle                          acNext;
  232.     ControlRef                      acOwner;
  233.     CCTabHandle                     acCTable;
  234.     SInt16                          acFlags;
  235.     SInt32                          acReserved;
  236.     SInt32                          acRefCon;
  237. };
  238. typedef struct AuxCtlRec                AuxCtlRec;
  240. typedef AuxCtlRec *                     AuxCtlPtr;
  241. typedef AuxCtlPtr *                     AuxCtlHandle;
  242. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  244. /*--------------------------------------------------------------------------------------*/
  245. /*  o Control Variants                                                                  */
  246. /*--------------------------------------------------------------------------------------*/
  247. typedef SInt16                          ControlVariant;
  248. enum {
  249.     kControlNoVariant           = 0,                            /* No variant*/
  250.     kControlUsesOwningWindowsFontVariant = 1 << 3               /* Control uses owning windows font to display text*/
  251. };
  254. /*--------------------------------------------------------------------------------------*/
  255. /*  o Control Part Codes                                                                */
  256. /*--------------------------------------------------------------------------------------*/
  257. /* Basic part codes */
  258. enum {
  259.     kControlNoPart              = 0,
  260.     kControlIndicatorPart       = 129,
  261.     kControlDisabledPart        = 254,
  262.     kControlInactivePart        = 255
  263. };
  265. /* Use this constant in Get/SetControlData when the data referred to is not         */
  266. /* specific to a part, but rather the entire control, e.g. the list handle of a     */
  267. /* list box control.                                                                */
  268. enum {
  269.     kControlEntireControl       = 0
  270. };
  272. /*  Meta-Parts                                                                          */
  273. /*                                                                                      */
  274. /*  If you haven't guessed from looking at other toolbox headers. We like the word      */
  275. /*  'meta'. It's cool. So here's one more for you. A meta-part is a part used in a call */
  276. /*  to the GetControlRegion API. These parts are parts that might be defined by a       */
  277. /*  control, but should not be returned from calls like TestControl, et al. They define */
  278. /*  a region of a control, presently the structure and the content region. The content  */
  279. /*  region is only defined by controls that can embed other controls. It is the area    */
  280. /*  that embedded content can live.                                                     */
  281. /*                                                                                      */
  282. /*  Along with these parts, you can also pass in normal part codes to get the regions   */
  283. /*  of the parts. Not all controls fully support this at the time this was written.     */
  284. enum {
  285.     kControlStructureMetaPart   = -1,
  286.     kControlContentMetaPart     = -2
  287. };
  289. /* focusing part codes */
  290. enum {
  291.     kControlFocusNoPart         = 0,                            /* tells control to clear its focus*/
  292.     kControlFocusNextPart       = -1,                           /* tells control to focus on the next part*/
  293.     kControlFocusPrevPart       = -2                            /* tells control to focus on the previous part*/
  294. };
  296. typedef SInt16                          ControlFocusPart;
  297. /*------------------------------------------------------------------------------------------------------*/
  298. /*  o Control Collection Tags                                                                           */
  299. /*------------------------------------------------------------------------------------------------------*/
  300. /*  These are standard tags that you will find in a flattened Control's Collection.                     */
  301. /*                                                                                                      */
  302. /*  All tags at ID zero in a flattened Control's Collection is reserved for Control Manager use.        */
  303. /*  Custom control definitions should use other IDs.                                                    */
  304. /*                                                                                                      */
  305. /*  Most of these tags are interpreted when you call CreateCustomControl; the Control Manager will      */
  306. /*  put value in the right place before calling the Control Definition with the initialization message. */
  307. /*  Other tags are only interpreted when calling UnflattenControl.                                      */
  308. enum {
  309.     kControlCollectionTagBounds = FOUR_CHAR_CODE('boun'),       /* Rect - the bounding rectangle*/
  310.     kControlCollectionTagValue  = FOUR_CHAR_CODE('valu'),       /* SInt32 - the value*/
  311.     kControlCollectionTagMinimum = FOUR_CHAR_CODE('min '),      /* SInt32 - the minimum*/
  312.     kControlCollectionTagMaximum = FOUR_CHAR_CODE('max '),      /* SInt32 - the maximum*/
  313.     kControlCollectionTagViewSize = FOUR_CHAR_CODE('view'),     /* SInt32 - the view size*/
  314.     kControlCollectionTagVisibility = FOUR_CHAR_CODE('visi'),   /* Boolean - the visible state*/
  315.     kControlCollectionTagRefCon = FOUR_CHAR_CODE('refc'),       /* SInt32 - the refCon*/
  316.     kControlCollectionTagTitle  = FOUR_CHAR_CODE('titl')        /* arbitrarily sized character array - the title*/
  317. };
  319. /*  The following are additional tags which are only interpreted by UnflattenControl. */
  320. enum {
  321.     kControlCollectionTagSubControls = FOUR_CHAR_CODE('subc')   /* data for all of a control's subcontrols*/
  322. };
  325. /*------------------------------------------------------------------------------------------------------*/
  326. /*  o Control Image Content                                                                             */
  327. /*------------------------------------------------------------------------------------------------------*/
  328. enum {
  329.     kControlContentTextOnly     = 0,
  330.     kControlNoContent           = 0,
  331.     kControlContentIconSuiteRes = 1,
  332.     kControlContentCIconRes     = 2,
  333.     kControlContentPictRes      = 3,
  334.     kControlContentICONRes      = 4,
  335.     kControlContentIconSuiteHandle = 129,
  336.     kControlContentCIconHandle  = 130,
  337.     kControlContentPictHandle   = 131,
  338.     kControlContentIconRef      = 132,
  339.     kControlContentICON         = 133
  340. };
  342. typedef SInt16                          ControlContentType;
  344. struct ControlButtonContentInfo {
  345.     ControlContentType              contentType;
  346.     union {
  347.         SInt16                          resID;
  348.         CIconHandle                     cIconHandle;
  349.         Handle                          iconSuite;
  350.         IconRef                         iconRef;
  351.         PicHandle                       picture;
  352.         Handle                          ICONHandle;
  353.     }                                 u;
  354. };
  355. typedef struct ControlButtonContentInfo ControlButtonContentInfo;
  356. typedef ControlButtonContentInfo *      ControlButtonContentInfoPtr;
  358. typedef ControlButtonContentInfo        ControlImageContentInfo;
  359. typedef ControlButtonContentInfo *      ControlImageContentInfoPtr;
  360. /*------------------------------------------------------------------------------------------------------*/
  361. /*  o Control Key Script Behavior                                                                       */
  362. /*------------------------------------------------------------------------------------------------------*/
  363. enum {
  364.     kControlKeyScriptBehaviorAllowAnyScript = FOUR_CHAR_CODE('any '), /* leaves the current keyboard alone and allows user to change the keyboard.*/
  365.     kControlKeyScriptBehaviorPrefersRoman = FOUR_CHAR_CODE('prmn'), /* switches the keyboard to roman, but allows them to change it as desired.*/
  366.     kControlKeyScriptBehaviorRequiresRoman = FOUR_CHAR_CODE('rrmn') /* switches the keyboard to roman and prevents the user from changing it.*/
  367. };
  369. typedef UInt32                          ControlKeyScriptBehavior;
  370. /*------------------------------------------------------------------------------------------------------*/
  371. /*  o Control Font Style                                                                                */
  372. /*------------------------------------------------------------------------------------------------------*/
  373. /*    SPECIAL FONT USAGE NOTES: You can specify the font to use for many control types.
  374.     The constants below are meta-font numbers which you can use to set a particular
  375.     control's font usage. There are essentially two modes you can use: 1) default,
  376.     which is essentially the same as it always has been, i.e. it uses the system font, unless
  377.     directed to use the window font via a control variant. 2) you can specify to use
  378.     the big or small system font in a generic manner. The Big system font is the font
  379.     used in menus, etc. Chicago has filled that role for some time now. Small system
  380.     font is currently Geneva 10. The meta-font number implies the size and style.
  382.     NOTE:       Not all font attributes are used by all controls. Most, in fact, ignore
  383.                 the fore and back color (Static Text is the only one that does, for
  384.                 backwards compatibility). Also size, face, and addFontSize are ignored
  385.                 when using the meta-font numbering.
  386. */
  387. /* Meta-font numbering - see note above */
  388. enum {
  389.     kControlFontBigSystemFont   = -1,                           /* force to big system font*/
  390.     kControlFontSmallSystemFont = -2,                           /* force to small system font*/
  391.     kControlFontSmallBoldSystemFont = -3,                       /* force to small bold system font*/
  392.     kControlFontViewSystemFont  = -4                            /* force to views system font (DataBrowser control only)*/
  393. };
  395. /* Add these masks together to set the flags field of a ControlFontStyleRec */
  396. /* They specify which fields to apply to the text. It is important to make  */
  397. /* sure that you specify only the fields that you wish to set.              */
  398. enum {
  399.     kControlUseFontMask         = 0x0001,
  400.     kControlUseFaceMask         = 0x0002,
  401.     kControlUseSizeMask         = 0x0004,
  402.     kControlUseForeColorMask    = 0x0008,
  403.     kControlUseBackColorMask    = 0x0010,
  404.     kControlUseModeMask         = 0x0020,
  405.     kControlUseJustMask         = 0x0040,
  406.     kControlUseAllMask          = 0x00FF,
  407.     kControlAddFontSizeMask     = 0x0100
  408. };
  410. /* AddToMetaFont indicates that we want to start with a standard system     */
  411. /* font, but then we'd like to add the other attributes. Normally, the meta */
  412. /* font ignores all other flags                                             */
  413. enum {
  414.     kControlAddToMetaFontMask   = 0x0200                        /* Available in Appearance 1.1 or later*/
  415. };
  418. struct ControlFontStyleRec {
  419.     SInt16                          flags;
  420.     SInt16                          font;
  421.     SInt16                          size;
  422.     SInt16                          style;
  423.     SInt16                          mode;
  424.     SInt16                          just;
  425.     RGBColor                        foreColor;
  426.     RGBColor                        backColor;
  427. };
  428. typedef struct ControlFontStyleRec      ControlFontStyleRec;
  430. typedef ControlFontStyleRec *           ControlFontStylePtr;
  431. /*------------------------------------------------------------------------------------------------------*/
  432. /*  o Click Activation Results                                                                          */
  433. /*------------------------------------------------------------------------------------------------------*/
  434. /*  These are for use with GetControlClickActivation. The enumerated values should be pretty            */
  435. /*  self-explanatory, but just in case:                                                                 */
  436. /*  o Activate/DoNotActivate indicates whether or not to change the owning window's z-ordering before   */
  437. /*      processing the click. If activation is requested, you may also want to immediately redraw the   */
  438. /*      newly exposed portion of the window.                                                            */
  439. /*  o Ignore/Handle Click indicates whether or not to call an appropriate click handling API (like      */
  440. /*      HandleControlClick) in respose to the event.                                                    */
  441. enum {
  442.     kDoNotActivateAndIgnoreClick = 0,                           /* probably never used. here for completeness.*/
  443.     kDoNotActivateAndHandleClick = 1,                           /* let the control handle the click while the window is still in the background.*/
  444.     kActivateAndIgnoreClick     = 2,                            /* control doesn't want to respond directly to the click, but window should still be brought forward.*/
  445.     kActivateAndHandleClick     = 3                             /* control wants to respond to the click, but only after the window has been activated.*/
  446. };
  448. typedef UInt32                          ClickActivationResult;
  449. /*------------------------------------------------------------------------------------------------------*/
  450. /*  o Common data tags for Get/SetControlData                                                           */
  451. /*------------------------------------------------------------------------------------------------------*/
  452. enum {
  453.     kControlFontStyleTag        = FOUR_CHAR_CODE('font'),
  454.     kControlKeyFilterTag        = FOUR_CHAR_CODE('fltr')
  455. };
  458. /*------------------------------------------------------------------------------------------------------*/
  459. /*  o Control Feature Bits                                                                              */
  460. /*------------------------------------------------------------------------------------------------------*/
  461. enum {
  462.                                                                 /* Control feature bits - returned by GetControlFeatures */
  463.     kControlSupportsGhosting    = 1 << 0,
  464.     kControlSupportsEmbedding   = 1 << 1,
  465.     kControlSupportsFocus       = 1 << 2,
  466.     kControlWantsIdle           = 1 << 3,
  467.     kControlWantsActivate       = 1 << 4,
  468.     kControlHandlesTracking     = 1 << 5,
  469.     kControlSupportsDataAccess  = 1 << 6,
  470.     kControlHasSpecialBackground = 1 << 7,
  471.     kControlGetsFocusOnClick    = 1 << 8,
  472.     kControlSupportsCalcBestRect = 1 << 9,
  473.     kControlSupportsLiveFeedback = 1 << 10,
  474.     kControlHasRadioBehavior    = 1 << 11,                      /* Available in Appearance 1.0.1 or later*/
  475.     kControlSupportsDragAndDrop = 1 << 12,                      /* Available in Carbon*/
  476.     kControlAutoToggles         = 1 << 14,                      /* Available in Appearance 1.1 or later*/
  477.     kControlSupportsGetRegion   = 1 << 17,                      /* Available in Appearance 1.1 or later*/
  478.     kControlSupportsFlattening  = 1 << 19,                      /* Available in Carbon*/
  479.     kControlSupportsSetCursor   = 1 << 20,                      /* Available in Carbon*/
  480.     kControlSupportsContextualMenus = 1 << 21,                  /* Available in Carbon*/
  481.     kControlSupportsClickActivation = 1 << 22                   /* Available in Carbon*/
  482. };
  484. /*------------------------------------------------------------------------------------------------------*/
  485. /*  o Control Messages                                                                                  */
  486. /*------------------------------------------------------------------------------------------------------*/
  487. enum {
  488.     drawCntl                    = 0,
  489.     testCntl                    = 1,
  490.     calcCRgns                   = 2,
  491.     initCntl                    = 3,
  492.     dispCntl                    = 4,
  493.     posCntl                     = 5,
  494.     thumbCntl                   = 6,
  495.     dragCntl                    = 7,
  496.     autoTrack                   = 8,
  497.     calcCntlRgn                 = 10,
  498.     calcThumbRgn                = 11,
  499.     drawThumbOutline            = 12,
  500.     kControlMsgDrawGhost        = 13,
  501.     kControlMsgCalcBestRect     = 14,                           /* Calculate best fitting rectangle for control*/
  502.     kControlMsgHandleTracking   = 15,
  503.     kControlMsgFocus            = 16,                           /* param indicates action.*/
  504.     kControlMsgKeyDown          = 17,
  505.     kControlMsgIdle             = 18,
  506.     kControlMsgGetFeatures      = 19,
  507.     kControlMsgSetData          = 20,
  508.     kControlMsgGetData          = 21,
  509.     kControlMsgActivate         = 22,
  510.     kControlMsgSetUpBackground  = 23,
  511.     kControlMsgCalcValueFromPos = 26,
  512.     kControlMsgTestNewMsgSupport = 27,                          /* See if this control supports new messaging*/
  513.     kControlMsgSubValueChanged  = 25,                           /* Available in Appearance 1.0.1 or later*/
  514.     kControlMsgSubControlAdded  = 28,                           /* Available in Appearance 1.0.1 or later*/
  515.     kControlMsgSubControlRemoved = 29,                          /* Available in Appearance 1.0.1 or later*/
  516.     kControlMsgApplyTextColor   = 30,                           /* Available in Appearance 1.1 or later*/
  517.     kControlMsgGetRegion        = 31,                           /* Available in Appearance 1.1 or later*/
  518.     kControlMsgFlatten          = 32,                           /* Available in Carbon. Param is Collection.*/
  519.     kControlMsgSetCursor        = 33,                           /* Available in Carbon. Param is ControlSetCursorRec*/
  520.     kControlMsgDragEnter        = 38,                           /* Available in Carbon. Param is DragRef, result is boolean indicating acceptibility of drag.*/
  521.     kControlMsgDragLeave        = 39,                           /* Available in Carbon. As above.*/
  522.     kControlMsgDragWithin       = 40,                           /* Available in Carbon. As above.*/
  523.     kControlMsgDragReceive      = 41,                           /* Available in Carbon. Param is DragRef, result is OSStatus indicating success/failure.*/
  524.     kControlMsgDisplayDebugInfo = 46,                           /* Available in Carbon on X.*/
  525.     kControlMsgContextualMenuClick = 47,                        /* Available in Carbon. Param is ControlContextualMenuClickRec*/
  526.     kControlMsgGetClickActivation = 48                          /* Available in Carbon. Param is ControlClickActivationRec*/
  527. };
  529. typedef SInt16                          ControlDefProcMessage;
  530. /*--------------------------------------------------------------------------------------*/
  531. /*  o Constants for drawCntl message (passed in param)                                  */
  532. /*--------------------------------------------------------------------------------------*/
  533. enum {
  534.     kDrawControlEntireControl   = 0,
  535.     kDrawControlIndicatorOnly   = 129
  536. };
  538. /*--------------------------------------------------------------------------------------*/
  539. /*  o Constants for dragCntl message (passed in param)                                  */
  540. /*--------------------------------------------------------------------------------------*/
  541. enum {
  542.     kDragControlEntireControl   = 0,
  543.     kDragControlIndicator       = 1
  544. };
  546. /*--------------------------------------------------------------------------------------*/
  547. /*  o Drag Constraint Structure for thumbCntl message (passed in param)                 */
  548. /*--------------------------------------------------------------------------------------*/
  550. struct IndicatorDragConstraint {
  551.     Rect                            limitRect;
  552.     Rect                            slopRect;
  553.     DragConstraint                  axis;
  554. };
  555. typedef struct IndicatorDragConstraint  IndicatorDragConstraint;
  556. typedef IndicatorDragConstraint *       IndicatorDragConstraintPtr;
  557. /*--------------------------------------------------------------------------------------*/
  558. /*  CDEF should return as result of kControlMsgTestNewMsgSupport                        */
  559. /*--------------------------------------------------------------------------------------*/
  560. enum {
  561.     kControlSupportsNewMessages = FOUR_CHAR_CODE(' ok ')
  562. };
  564. /*--------------------------------------------------------------------------------------*/
  565. /*  This structure is passed into a CDEF when called with the kControlMsgHandleTracking */
  566. /*  message                                                                             */
  567. /*--------------------------------------------------------------------------------------*/
  569. struct ControlTrackingRec {
  570.     Point                           startPt;
  571.     EventModifiers                  modifiers;
  572.     ControlActionUPP                action;
  573. };
  574. typedef struct ControlTrackingRec       ControlTrackingRec;
  576. typedef ControlTrackingRec *            ControlTrackingPtr;
  577. /*--------------------------------------------------------------------------------------*/
  578. /* This structure is passed into a CDEF when called with the kControlMsgKeyDown message */
  579. /*--------------------------------------------------------------------------------------*/
  581. struct ControlKeyDownRec {
  582.     EventModifiers                  modifiers;
  583.     SInt16                          keyCode;
  584.     SInt16                          charCode;
  585. };
  586. typedef struct ControlKeyDownRec        ControlKeyDownRec;
  588. typedef ControlKeyDownRec *             ControlKeyDownPtr;
  589. /*--------------------------------------------------------------------------------------*/
  590. /* This structure is passed into a CDEF when called with the kControlMsgGetData or      */
  591. /* kControlMsgSetData message                                                           */
  592. /*--------------------------------------------------------------------------------------*/
  594. struct ControlDataAccessRec {
  595.     ResType                         tag;
  596.     ResType                         part;
  597.     Size                            size;
  598.     Ptr                             dataPtr;
  599. };
  600. typedef struct ControlDataAccessRec     ControlDataAccessRec;
  602. typedef ControlDataAccessRec *          ControlDataAccessPtr;
  603. /*--------------------------------------------------------------------------------------*/
  604. /* This structure is passed into a CDEF when called with the kControlCalcBestRect msg   */
  605. /*--------------------------------------------------------------------------------------*/
  607. struct ControlCalcSizeRec {
  608.     SInt16                          height;
  609.     SInt16                          width;
  610.     SInt16                          baseLine;
  611. };
  612. typedef struct ControlCalcSizeRec       ControlCalcSizeRec;
  614. typedef ControlCalcSizeRec *            ControlCalcSizePtr;
  615. /*--------------------------------------------------------------------------------------*/
  616. /* This structure is passed into a CDEF when called with the kControlMsgSetUpBackground */
  617. /* message is sent                                                                      */
  618. /*--------------------------------------------------------------------------------------*/
  620. struct ControlBackgroundRec {
  621.     SInt16                          depth;
  622.     Boolean                         colorDevice;
  623. };
  624. typedef struct ControlBackgroundRec     ControlBackgroundRec;
  626. typedef ControlBackgroundRec *          ControlBackgroundPtr;
  627. /*--------------------------------------------------------------------------------------*/
  628. /* This structure is passed into a CDEF when called with the kControlMsgApplyTextColor  */
  629. /* message is sent                                                                      */
  630. /*--------------------------------------------------------------------------------------*/
  632. struct ControlApplyTextColorRec {
  633.     SInt16                          depth;
  634.     Boolean                         colorDevice;
  635.     Boolean                         active;
  636. };
  637. typedef struct ControlApplyTextColorRec ControlApplyTextColorRec;
  639. typedef ControlApplyTextColorRec *      ControlApplyTextColorPtr;
  640. /*--------------------------------------------------------------------------------------*/
  641. /* This structure is passed into a CDEF when called with the kControlMsgGetRegion       */
  642. /* message is sent                                                                      */
  643. /*--------------------------------------------------------------------------------------*/
  645. struct ControlGetRegionRec {
  646.     RgnHandle                       region;
  647.     ControlPartCode                 part;
  648. };
  649. typedef struct ControlGetRegionRec      ControlGetRegionRec;
  651. typedef ControlGetRegionRec *           ControlGetRegionPtr;
  652. /*--------------------------------------------------------------------------------------*/
  653. /* This structure is passed into a CDEF when the kControlMsgSetCursor message is sent   */
  654. /* Only sent on Carbon                                                                  */
  655. /*--------------------------------------------------------------------------------------*/
  657. struct ControlSetCursorRec {
  658.     Point                           localPoint;
  659.     EventModifiers                  modifiers;
  660.     Boolean                         cursorWasSet;               /* your CDEF must set this to true if you set the cursor, or false otherwise*/
  661. };
  662. typedef struct ControlSetCursorRec      ControlSetCursorRec;
  664. typedef ControlSetCursorRec *           ControlSetCursorPtr;
  665. /*--------------------------------------------------------------------------------------*/
  666. /* This structure is passed into a CDEF when the kControlMsgContextualMenuClick message */
  667. /* is sent                                                                              */
  668. /* Only sent on Carbon                                                                  */
  669. /*--------------------------------------------------------------------------------------*/
  671. struct ControlContextualMenuClickRec {
  672.     Point                           localPoint;
  673.     Boolean                         menuDisplayed;              /* your CDEF must set this to true if you displayed a menu, or false otherwise*/
  674. };
  675. typedef struct ControlContextualMenuClickRec ControlContextualMenuClickRec;
  677. typedef ControlContextualMenuClickRec * ControlContextualMenuClickPtr;
  678. /*--------------------------------------------------------------------------------------*/
  679. /* This structure is passed into a CDEF when the kControlMsgGetClickActivation message  */
  680. /* is sent                                                                              */
  681. /* Only sent on Carbon                                                                  */
  682. /*--------------------------------------------------------------------------------------*/
  684. struct ControlClickActivationRec {
  685.     Point                           localPoint;
  686.     EventModifiers                  modifiers;
  687.     ClickActivationResult           result;                     /* your CDEF must pass the desired result back*/
  688. };
  689. typedef struct ControlClickActivationRec ControlClickActivationRec;
  691. typedef ControlClickActivationRec *     ControlClickActivationPtr;
  692. /*--------------------------------------------------------------------------------------*/
  693. /*  o 'CDEF' entrypoint                                                                 */
  694. /*--------------------------------------------------------------------------------------*/
  695. typedef CALLBACK_API( SInt32 , ControlDefProcPtr )(SInt16 varCode, ControlRef theControl, ControlDefProcMessage message, SInt32 param);
  696. typedef STACK_UPP_TYPE(ControlDefProcPtr)                       ControlDefUPP;
  697. #if OPAQUE_UPP_TYPES
  698.     EXTERN_API(ControlDefUPP)
  699.     NewControlDefUPP               (ControlDefProcPtr       userRoutine);
  701.     EXTERN_API(void)
  702.     DisposeControlDefUPP           (ControlDefUPP           userUPP);
  704.     EXTERN_API(SInt32)
  705.     InvokeControlDefUPP            (SInt16                  varCode,
  706.                                     ControlRef              theControl,
  707.                                     ControlDefProcMessage   message,
  708.                                     SInt32                  param,
  709.                                     ControlDefUPP           userUPP);
  711. #else
  712.     enum { uppControlDefProcInfo = 0x00003BB0 };                    /* pascal 4_bytes Func(2_bytes, 4_bytes, 2_bytes, 4_bytes) */
  713.     #define NewControlDefUPP(userRoutine)                           (ControlDefUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppControlDefProcInfo, GetCurrentArchitecture())
  714.     #define DisposeControlDefUPP(userUPP)                           DisposeRoutineDescriptor(userUPP)
  715.     #define InvokeControlDefUPP(varCode, theControl, message, param, userUPP)  (SInt32)CALL_FOUR_PARAMETER_UPP((userUPP), uppControlDefProcInfo, (varCode), (theControl), (message), (param))
  716. #endif
  717. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  718. #define NewControlDefProc(userRoutine)                          NewControlDefUPP(userRoutine)
  719. #define CallControlDefProc(userRoutine, varCode, theControl, message, param) InvokeControlDefUPP(varCode, theControl, message, param, userRoutine)
  720. /*--------------------------------------------------------------------------------------*/
  721. /*  Control Key Filter                                                                  */
  722. /*--------------------------------------------------------------------------------------*/
  723. /* Certain controls can have a keyfilter attached to them.                              */
  724. /* Definition of a key filter for intercepting and possibly changing keystrokes         */
  725. /* which are destined for a control.                                                    */
  726. /* Key Filter Result Codes                                                          */
  727. /* The filter proc should return one of the two constants below. If                 */
  728. /* kKeyFilterBlockKey is returned, the key is blocked and never makes it to the     */
  729. /* control. If kKeyFilterPassKey is returned, the control receives the keystroke.   */
  730. enum {
  731.     kControlKeyFilterBlockKey   = 0,
  732.     kControlKeyFilterPassKey    = 1
  733. };
  735. typedef SInt16                          ControlKeyFilterResult;
  736. typedef CALLBACK_API( ControlKeyFilterResult , ControlKeyFilterProcPtr )(ControlRef theControl, SInt16 *keyCode, SInt16 *charCode, EventModifiers *modifiers);
  737. typedef STACK_UPP_TYPE(ControlKeyFilterProcPtr)                 ControlKeyFilterUPP;
  738. #if OPAQUE_UPP_TYPES
  739.     EXTERN_API(ControlKeyFilterUPP)
  740.     NewControlKeyFilterUPP         (ControlKeyFilterProcPtr userRoutine);
  742.     EXTERN_API(void)
  743.     DisposeControlKeyFilterUPP     (ControlKeyFilterUPP     userUPP);
  745.     EXTERN_API(ControlKeyFilterResult)
  746.     InvokeControlKeyFilterUPP      (ControlRef              theControl,
  747.                                     SInt16 *                keyCode,
  748.                                     SInt16 *                charCode,
  749.                                     EventModifiers *        modifiers,
  750.                                     ControlKeyFilterUPP     userUPP);
  752. #else
  753.     enum { uppControlKeyFilterProcInfo = 0x00003FE0 };              /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */
  754.     #define NewControlKeyFilterUPP(userRoutine)                     (ControlKeyFilterUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppControlKeyFilterProcInfo, GetCurrentArchitecture())
  755.     #define DisposeControlKeyFilterUPP(userUPP)                     DisposeRoutineDescriptor(userUPP)
  756.     #define InvokeControlKeyFilterUPP(theControl, keyCode, charCode, modifiers, userUPP)  (ControlKeyFilterResult)CALL_FOUR_PARAMETER_UPP((userUPP), uppControlKeyFilterProcInfo, (theControl), (keyCode), (charCode), (modifiers))
  757. #endif
  758. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  759. #define NewControlKeyFilterProc(userRoutine)                    NewControlKeyFilterUPP(userRoutine)
  760. #define CallControlKeyFilterProc(userRoutine, theControl, keyCode, charCode, modifiers) InvokeControlKeyFilterUPP(theControl, keyCode, charCode, modifiers, userRoutine)
  762. /*--------------------------------------------------------------------------------------*/
  763. /*  o DragGrayRgn Constatns                                                             */
  764. /*                                                                                      */
  765. /*   For DragGrayRgnUPP used in TrackControl()                                          */
  766. /*--------------------------------------------------------------------------------------*/
  767. enum {
  768.     noConstraint                = kNoConstraint,
  769.     hAxisOnly                   = 1,
  770.     vAxisOnly                   = 2
  771. };
  773. /*--------------------------------------------------------------------------------------*/
  774. /*  o Control Creation/Deletion/Persistence                                             */
  775. /*--------------------------------------------------------------------------------------*/
  776. /*  CreateCustomControl is only available as part of Carbon                             */
  777. enum {
  778.     kControlDefProcPtr          = 0                             /* raw proc-ptr based access*/
  779. };
  781. typedef UInt32                          ControlDefType;
  783. struct ControlDefSpec {
  784.     ControlDefType                  defType;
  785.     union {
  786.         ControlDefUPP                   defProc;
  787.     }                                 u;
  788. };
  789. typedef struct ControlDefSpec           ControlDefSpec;
  790. EXTERN_API( OSStatus )
  791. CreateCustomControl             (WindowRef              owningWindow,
  792.                                  const Rect *           contBounds,
  793.                                  const ControlDefSpec * def,
  794.                                  Collection             initData,
  795.                                  ControlRef *           outControl);
  797. EXTERN_API( ControlRef )
  798. NewControl                      (WindowPtr              owningWindow,
  799.                                  const Rect *           boundsRect,
  800.                                  ConstStr255Param       controlTitle,
  801.                                  Boolean                initiallyVisible,
  802.                                  SInt16                 initialValue,
  803.                                  SInt16                 minimumValue,
  804.                                  SInt16                 maximumValue,
  805.                                  SInt16                 procID,
  806.                                  SInt32                 controlReference)                   ONEWORDINLINE(0xA954);
  808. EXTERN_API( ControlRef )
  809. GetNewControl                   (SInt16                 resourceID,
  810.                                  WindowPtr              owningWindow)                       ONEWORDINLINE(0xA9BE);
  812. EXTERN_API( void )
  813. DisposeControl                  (ControlRef             theControl)                         ONEWORDINLINE(0xA955);
  815. EXTERN_API( void )
  816. KillControls                    (WindowPtr              theWindow)                          ONEWORDINLINE(0xA956);
  818. #if CALL_NOT_IN_CARBON
  819. EXTERN_API( OSStatus )
  820. FlattenControl                  (ControlRef             control,
  821.                                  Boolean                flattenSubControls,
  822.                                  Collection             collection);
  824. EXTERN_API( OSStatus )
  825. UnflattenControl                (WindowRef              window,
  826.                                  Collection             collection,
  827.                                  ControlRef *           outControl);
  829. #endif  /* CALL_NOT_IN_CARBON */
  831. /*--------------------------------------------------------------------------------------*/
  832. /*  o Control Definition Registration                                                   */
  833. /*--------------------------------------------------------------------------------------*/
  834. /*  In GetNewControl on Carbon, the Control Manager needs to know how to map the procID */
  835. /*  to a ControlDefSpec. With RegisterControlDefinition, your application can inform    */
  836. /*  the Control Manager which ControlDefSpec to call when it sees a request to use a    */
  837. /*  'CDEF' of a particular resource ID.                                                 */
  838. /*                                                                                      */
  839. /*  Since custom control definitions receive their initialization data in a Collection, */
  840. /*  you must also provide a procedure to convert the bounds, min, max, and other fields */
  841. /*  from the 'CNTL' resource into a Collection. If you don't provide a conversion proc, */
  842. /*  your control will receive an empty collection when it is sent the initialization    */
  843. /*  message.                                                                                */
  844. /*  If you want the value, min, visibility, etc. to be given to the control, you must   */
  845. /*  add the appropriate tagged data to the collection. See the Control Collection Tags  */
  846. /*  above.                                                                              */
  847. /*  RegisterControlDefinition is only available as part of Carbon                       */
  848. typedef CALLBACK_API( OSStatus , ControlCNTLToCollectionProcPtr )(const Rect *bounds, SInt16 value, Boolean visible, SInt16 max, SInt16 min, SInt16 procID, SInt32 refCon, ConstStr255Param title, Collection collection);
  849. typedef STACK_UPP_TYPE(ControlCNTLToCollectionProcPtr)          ControlCNTLToCollectionUPP;
  850. #if OPAQUE_UPP_TYPES
  851.     EXTERN_API(ControlCNTLToCollectionUPP)
  852.     NewControlCNTLToCollectionUPP    (ControlCNTLToCollectionProcPtr userRoutine);
  854.     EXTERN_API(void)
  855.     DisposeControlCNTLToCollectionUPP    (ControlCNTLToCollectionUPP userUPP);
  857.     EXTERN_API(OSStatus)
  858.     InvokeControlCNTLToCollectionUPP    (const Rect *       bounds,
  859.                                     SInt16                  value,
  860.                                     Boolean                 visible,
  861.                                     SInt16                  max,
  862.                                     SInt16                  min,
  863.                                     SInt16                  procID,
  864.                                     SInt32                  refCon,
  865.                                     ConstStr255Param        title,
  866.                                     Collection              collection,
  867.                                     ControlCNTLToCollectionUPP userUPP);
  869. #else
  870.     enum { uppControlCNTLToCollectionProcInfo = 0x00FEA6F0 };       /* pascal 4_bytes Func(4_bytes, 2_bytes, 1_byte, 2_bytes, 2_bytes, 2_bytes, 4_bytes, 4_bytes, 4_bytes) */
  871.     #define NewControlCNTLToCollectionUPP(userRoutine)              (ControlCNTLToCollectionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppControlCNTLToCollectionProcInfo, GetCurrentArchitecture())
  872.     #define DisposeControlCNTLToCollectionUPP(userUPP)              DisposeRoutineDescriptor(userUPP)
  873.     #define InvokeControlCNTLToCollectionUPP(bounds, value, visible, max, min, procID, refCon, title, collection, userUPP)  (OSStatus)CALL_NINE_PARAMETER_UPP((userUPP), uppControlCNTLToCollectionProcInfo, (bounds), (value), (visible), (max), (min), (procID), (refCon), (title), (collection))
  874. #endif
  875. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  876. #define NewControlCNTLToCollectionProc(userRoutine)             NewControlCNTLToCollectionUPP(userRoutine)
  877. #define CallControlCNTLToCollectionProc(userRoutine, bounds, value, visible, max, min, procID, refCon, title, collection) InvokeControlCNTLToCollectionUPP(bounds, value, visible, max, min, procID, refCon, title, collection, userRoutine)
  878. EXTERN_API( OSStatus )
  879. RegisterControlDefinition       (SInt16                 CDEFResID,
  880.                                  const ControlDefSpec * def,
  881.                                  ControlCNTLToCollectionUPP  conversionProc);
  885. /*--------------------------------------------------------------------------------------*/
  886. /*  o Control Visible State                                                             */
  887. /*--------------------------------------------------------------------------------------*/
  888. EXTERN_API( void )
  889. HiliteControl                   (ControlRef             theControl,
  890.                                  ControlPartCode        hiliteState)                        ONEWORDINLINE(0xA95D);
  892. EXTERN_API( void )
  893. ShowControl                     (ControlRef             theControl)                         ONEWORDINLINE(0xA957);
  895. EXTERN_API( void )
  896. HideControl                     (ControlRef             theControl)                         ONEWORDINLINE(0xA958);
  899. /* following state routines available only with Appearance 1.0 and later*/
  900. EXTERN_API( Boolean )
  901. IsControlActive                 (ControlRef             inControl)                          THREEWORDINLINE(0x303C, 0x0005, 0xAA73);
  903. EXTERN_API( Boolean )
  904. IsControlVisible                (ControlRef             inControl)                          THREEWORDINLINE(0x303C, 0x0006, 0xAA73);
  906. EXTERN_API( OSErr )
  907. ActivateControl                 (ControlRef             inControl)                          THREEWORDINLINE(0x303C, 0x0007, 0xAA73);
  909. EXTERN_API( OSErr )
  910. DeactivateControl               (ControlRef             inControl)                          THREEWORDINLINE(0x303C, 0x0008, 0xAA73);
  912. EXTERN_API( OSErr )
  913. SetControlVisibility            (ControlRef             inControl,
  914.                                  Boolean                inIsVisible,
  915.                                  Boolean                inDoDraw)                           THREEWORDINLINE(0x303C, 0x001E, 0xAA73);
  918. /*--------------------------------------------------------------------------------------*/
  919. /*  o Control Imaging                                                                   */
  920. /*--------------------------------------------------------------------------------------*/
  921. EXTERN_API( void )
  922. DrawControls                    (WindowPtr              theWindow)                          ONEWORDINLINE(0xA969);
  924. EXTERN_API( void )
  925. Draw1Control                    (ControlRef             theControl)                         ONEWORDINLINE(0xA96D);
  927. #define DrawOneControl(theControl) Draw1Control(theControl)
  929. EXTERN_API( void )
  930. UpdateControls                  (WindowPtr              theWindow,
  931.                                  RgnHandle              updateRegion)                       ONEWORDINLINE(0xA953);
  934. /* following imaging routines available only with Appearance 1.0 and later*/
  935. EXTERN_API( OSErr )
  936. GetBestControlRect              (ControlRef             inControl,
  937.                                  Rect *                 outRect,
  938.                                  SInt16 *               outBaseLineOffset)                  THREEWORDINLINE(0x303C, 0x001B, 0xAA73);
  940. EXTERN_API( OSErr )
  941. SetControlFontStyle             (ControlRef             inControl,
  942.                                  const ControlFontStyleRec * inStyle)                       THREEWORDINLINE(0x303C, 0x001C, 0xAA73);
  944. EXTERN_API( void )
  945. DrawControlInCurrentPort        (ControlRef             inControl)                          THREEWORDINLINE(0x303C, 0x0018, 0xAA73);
  947. EXTERN_API( OSErr )
  948. SetUpControlBackground          (ControlRef             inControl,
  949.                                  SInt16                 inDepth,
  950.                                  Boolean                inIsColorDevice)                    THREEWORDINLINE(0x303C, 0x001D, 0xAA73);
  952. /* SetUpControlTextColor is available in Appearance 1.1 or later.*/
  953. EXTERN_API( OSErr )
  954. SetUpControlTextColor           (ControlRef             inControl,
  955.                                  SInt16                 inDepth,
  956.                                  Boolean                inIsColorDevice);
  959. /*--------------------------------------------------------------------------------------*/
  960. /*  o Control Mousing                                                                   */
  961. /*--------------------------------------------------------------------------------------*/
  962. /*
  963.     NOTE ON CONTROL ACTION PROCS
  965.     When using the TrackControl() call when tracking an indicator, the actionProc parameter
  966.     (type ControlActionUPP) should be replaced by a parameter of type DragGrayRgnUPP
  967.     (see Quickdraw.h).
  969.     If, however, you are using the live feedback variants of scroll bars or sliders, you
  970.     can pass a ControlActionUPP in when tracking the indicator as well. This functionality
  971.     is available in Appearance 1.0 or later.
  972. */
  973. EXTERN_API( ControlPartCode )
  974. TrackControl                    (ControlRef             theControl,
  975.                                  Point                  startPoint,
  976.                                  ControlActionUPP       actionProc) /* can be NULL */       ONEWORDINLINE(0xA968);
  978. EXTERN_API( void )
  979. DragControl                     (ControlRef             theControl,
  980.                                  Point                  startPoint,
  981.                                  const Rect *           limitRect,
  982.                                  const Rect *           slopRect,
  983.                                  DragConstraint         axis)                               ONEWORDINLINE(0xA967);
  985. EXTERN_API( ControlPartCode )
  986. TestControl                     (ControlRef             theControl,
  987.                                  Point                  testPoint)                          ONEWORDINLINE(0xA966);
  989. EXTERN_API( ControlPartCode )
  990. FindControl                     (Point                  testPoint,
  991.                                  WindowPtr              theWindow,
  992.                                  ControlRef *           theControl)                         ONEWORDINLINE(0xA96C);
  994. /* The following mousing routines available only with Appearance 1.0 and later  */
  995. /*                                                                              */
  996. /* HandleControlClick is preferable to TrackControl when running under          */
  997. /* Appearance 1.0 as you can pass in modifiers, which some of the new controls  */
  998. /* use, such as edit text and list boxes.                                       */
  999. EXTERN_API( ControlRef )
  1000. FindControlUnderMouse           (Point                  inWhere,
  1001.                                  WindowPtr              inWindow,
  1002.                                  SInt16 *               outPart)                            THREEWORDINLINE(0x303C, 0x0009, 0xAA73);
  1004. EXTERN_API( ControlPartCode )
  1005. HandleControlClick              (ControlRef             inControl,
  1006.                                  Point                  inWhere,
  1007.                                  EventModifiers         inModifiers,
  1008.                                  ControlActionUPP       inAction) /* can be NULL */         THREEWORDINLINE(0x303C, 0x000A, 0xAA73);
  1010. /* Contextual Menu support in the Control Manager is only available on Carbon.  */
  1011. /* If the control didn't display a contextual menu (possibly because the point  */
  1012. /* was in a non-interesting part), the menuDisplayed output parameter will be   */
  1013. /* false. If the control did display a menu, menuDisplayed will be true.        */
  1014. /* This in on Carbon only                                                       */
  1015. EXTERN_API( OSStatus )
  1016. HandleControlContextualMenuClick (ControlRef            inControl,
  1017.                                  Point                  inWhere,
  1018.                                  Boolean *              menuDisplayed);
  1020. /* Some complex controls (like Data Browser) require proper sequencing of       */
  1021. /* window activation and click processing. In some cases, the control might     */
  1022. /* want the window to be left inactive yet still handle the click, or vice-     */
  1023. /* versa. The GetControlClickActivation routine lets a control client ask the   */
  1024. /* control how it wishes to behave for a particular click.                      */
  1025. /* This in on Carbon only.                                                      */
  1026. EXTERN_API( OSStatus )
  1027. GetControlClickActivation       (ControlRef             inControl,
  1028.                                  Point                  inWhere,
  1029.                                  EventModifiers         inModifiers,
  1030.                                  ClickActivationResult * outResult);
  1033. /*--------------------------------------------------------------------------------------*/
  1034. /*  o Control Events (available only with Appearance 1.0 and later)                     */
  1035. /*--------------------------------------------------------------------------------------*/
  1036. EXTERN_API( SInt16 )
  1037. HandleControlKey                (ControlRef             inControl,
  1038.                                  SInt16                 inKeyCode,
  1039.                                  SInt16                 inCharCode,
  1040.                                  EventModifiers         inModifiers)                        THREEWORDINLINE(0x303C, 0x000B, 0xAA73);
  1042. EXTERN_API( void )
  1043. IdleControls                    (WindowPtr              inWindow)                           THREEWORDINLINE(0x303C, 0x000C, 0xAA73);
  1047. /*--------------------------------------------------------------------------------------*/
  1048. /* o Control Mouse Tracking (available with Carbon)                                     */
  1049. /*--------------------------------------------------------------------------------------*/
  1050. /* The HandleControlSetCursor routine requests that a given control set the cursor to   */
  1051. /* something appropriate based on the mouse location.                                   */
  1052. /* If the control didn't want to set the cursor (because the point was in a             */
  1053. /* non-interesting part), the cursorWasSet output parameter will be false. If the       */
  1054. /* control did set the cursor, cursorWasSet will be true.                               */
  1055. /* Carbon only.                                                                         */
  1056. EXTERN_API( OSStatus )
  1057. HandleControlSetCursor          (ControlRef             control,
  1058.                                  Point                  localPoint,
  1059.                                  EventModifiers         modifiers,
  1060.                                  Boolean *              cursorWasSet);
  1062. /*--------------------------------------------------------------------------------------*/
  1063. /*  o Control Positioning                                                               */
  1064. /*--------------------------------------------------------------------------------------*/
  1065. EXTERN_API( void )
  1066. MoveControl                     (ControlRef             theControl,
  1067.                                  SInt16                 h,
  1068.                                  SInt16                 v)                                  ONEWORDINLINE(0xA959);
  1070. EXTERN_API( void )
  1071. SizeControl                     (ControlRef             theControl,
  1072.                                  SInt16                 w,
  1073.                                  SInt16                 h)                                  ONEWORDINLINE(0xA95C);
  1075. /*--------------------------------------------------------------------------------------*/
  1076. /*  o Control Title                                                                     */
  1077. /*--------------------------------------------------------------------------------------*/
  1078. EXTERN_API( void )
  1079. SetControlTitle                 (ControlRef             theControl,
  1080.                                  ConstStr255Param       title)                              ONEWORDINLINE(0xA95F);
  1082. EXTERN_API( void )
  1083. GetControlTitle                 (ControlRef             theControl,
  1084.                                  Str255                 title)                              ONEWORDINLINE(0xA95E);
  1086. /*--------------------------------------------------------------------------------------*/
  1087. /*  o Control Value                                                                     */
  1088. /*--------------------------------------------------------------------------------------*/
  1089. EXTERN_API( SInt16 )
  1090. GetControlValue                 (ControlRef             theControl)                         ONEWORDINLINE(0xA960);
  1092. EXTERN_API( void )
  1093. SetControlValue                 (ControlRef             theControl,
  1094.                                  SInt16                 newValue)                           ONEWORDINLINE(0xA963);
  1096. EXTERN_API( SInt16 )
  1097. GetControlMinimum               (ControlRef             theControl)                         ONEWORDINLINE(0xA961);
  1099. EXTERN_API( void )
  1100. SetControlMinimum               (ControlRef             theControl,
  1101.                                  SInt16                 newMinimum)                         ONEWORDINLINE(0xA964);
  1103. EXTERN_API( SInt16 )
  1104. GetControlMaximum               (ControlRef             theControl)                         ONEWORDINLINE(0xA962);
  1106. EXTERN_API( void )
  1107. SetControlMaximum               (ControlRef             theControl,
  1108.                                  SInt16                 newMaximum)                         ONEWORDINLINE(0xA965);
  1111. /* proportional scrolling/32-bit value support is new with Appearance 1.1*/
  1113. EXTERN_API( SInt32 )
  1114. GetControlViewSize              (ControlRef             theControl);
  1116. EXTERN_API( void )
  1117. SetControlViewSize              (ControlRef             theControl,
  1118.                                  SInt32                 newViewSize);
  1120. EXTERN_API( SInt32 )
  1121. GetControl32BitValue            (ControlRef             theControl);
  1123. EXTERN_API( void )
  1124. SetControl32BitValue            (ControlRef             theControl,
  1125.                                  SInt32                 newValue);
  1127. EXTERN_API( SInt32 )
  1128. GetControl32BitMaximum          (ControlRef             theControl);
  1130. EXTERN_API( void )
  1131. SetControl32BitMaximum          (ControlRef             theControl,
  1132.                                  SInt32                 newMaximum);
  1134. EXTERN_API( SInt32 )
  1135. GetControl32BitMinimum          (ControlRef             theControl);
  1137. EXTERN_API( void )
  1138. SetControl32BitMinimum          (ControlRef             theControl,
  1139.                                  SInt32                 newMinimum);
  1141. /*
  1142.     IsValidControlHandle will tell you if the handle you pass in belongs to a control
  1143.     the Control Manager knows about. It does not sanity check the data in the control.
  1144. */
  1146. EXTERN_API( Boolean )
  1147. IsValidControlHandle            (ControlRef             theControl);
  1149. /*--------------------------------------------------------------------------------------*/
  1150. /* o Control IDs                                                                        */
  1151. /* Carbon only.                                                                         */
  1152. /*--------------------------------------------------------------------------------------*/
  1154. struct ControlID {
  1155.     OSType                          signature;
  1156.     SInt32                          id;
  1157. };
  1158. typedef struct ControlID                ControlID;
  1159. EXTERN_API( OSStatus )
  1160. SetControlID                    (ControlRef             inControl,
  1161.                                  const ControlID *      inID);
  1163. EXTERN_API( OSStatus )
  1164. GetControlID                    (ControlRef             inControl,
  1165.                                  ControlID *            outID);
  1167. EXTERN_API( OSStatus )
  1168. GetControlByID                  (WindowRef              inWindow,
  1169.                                  const ControlID *      inID,
  1170.                                  ControlRef *           outControl);
  1172. /*--------------------------------------------------------------------------------------*/
  1173. /* o Properties                                                                         */
  1174. /*--------------------------------------------------------------------------------------*/
  1175. enum {
  1176.     kControlPropertyPersistent  = 0x00000001                    /* whether this property gets saved when flattening the control*/
  1177. };
  1179. EXTERN_API( OSStatus )
  1180. GetControlProperty              (ControlRef             control,
  1181.                                  OSType                 propertyCreator,
  1182.                                  OSType                 propertyTag,
  1183.                                  UInt32                 bufferSize,
  1184.                                  UInt32 *               actualSize,
  1185.                                  void *                 propertyBuffer);
  1187. EXTERN_API( OSStatus )
  1188. GetControlPropertySize          (ControlRef             control,
  1189.                                  OSType                 propertyCreator,
  1190.                                  OSType                 propertyTag,
  1191.                                  UInt32 *               size);
  1193. EXTERN_API( OSStatus )
  1194. SetControlProperty              (ControlRef             control,
  1195.                                  OSType                 propertyCreator,
  1196.                                  OSType                 propertyTag,
  1197.                                  UInt32                 propertySize,
  1198.                                  void *                 propertyData);
  1200. EXTERN_API( OSStatus )
  1201. RemoveControlProperty           (ControlRef             control,
  1202.                                  OSType                 propertyCreator,
  1203.                                  OSType                 propertyTag);
  1205. EXTERN_API( OSStatus )
  1206. GetControlPropertyAttributes    (ControlRef             control,
  1207.                                  OSType                 propertyCreator,
  1208.                                  OSType                 propertyTag,
  1209.                                  UInt32 *               attributes);
  1211. EXTERN_API( OSStatus )
  1212. ChangeControlPropertyAttributes (ControlRef             control,
  1213.                                  OSType                 propertyCreator,
  1214.                                  OSType                 propertyTag,
  1215.                                  UInt32                 attributesToSet,
  1216.                                  UInt32                 attributesToClear);
  1218. /*--------------------------------------------------------------------------------------*/
  1219. /*  o Control Regions (Appearance 1.1 or later)                                         */
  1220. /*                                                                                      */
  1221. /*  See the discussion on meta-parts in this header for more information                */
  1222. /*--------------------------------------------------------------------------------------*/
  1223. EXTERN_API( OSStatus )
  1224. GetControlRegion                (ControlRef             inControl,
  1225.                                  ControlPartCode        inPart,
  1226.                                  RgnHandle              outRegion);
  1230. /*--------------------------------------------------------------------------------------*/
  1231. /*  o Control Variant                                                                   */
  1232. /*--------------------------------------------------------------------------------------*/
  1233. EXTERN_API( ControlVariant )
  1234. GetControlVariant               (ControlRef             theControl)                         ONEWORDINLINE(0xA809);
  1236. /*--------------------------------------------------------------------------------------*/
  1237. /*  o Control Action                                                                    */
  1238. /*--------------------------------------------------------------------------------------*/
  1239. EXTERN_API( void )
  1240. SetControlAction                (ControlRef             theControl,
  1241.                                  ControlActionUPP       actionProc)                         ONEWORDINLINE(0xA96B);
  1243. EXTERN_API( ControlActionUPP )
  1244. GetControlAction                (ControlRef             theControl)                         ONEWORDINLINE(0xA96A);
  1246. /*--------------------------------------------------------------------------------------*/
  1247. /* o Control Accessors                                                                  */
  1248. /*--------------------------------------------------------------------------------------*/
  1249. EXTERN_API( void )
  1250. SetControlReference             (ControlRef             theControl,
  1251.                                  SInt32                 data)                               ONEWORDINLINE(0xA95B);
  1253. EXTERN_API( SInt32 )
  1254. GetControlReference             (ControlRef             theControl)                         ONEWORDINLINE(0xA95A);
  1256. #if !OPAQUE_TOOLBOX_STRUCTS
  1257. EXTERN_API( Boolean )
  1258. GetAuxiliaryControlRecord       (ControlRef             theControl,
  1259.                                  AuxCtlHandle *         acHndl)                             ONEWORDINLINE(0xAA44);
  1261. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  1263. #if CALL_NOT_IN_CARBON
  1264. EXTERN_API( void )
  1265. SetControlColor                 (ControlRef             theControl,
  1266.                                  CCTabHandle            newColorTable)                      ONEWORDINLINE(0xAA43);
  1268. /*--------------------------------------------------------------------------------------*/
  1269. /*  o Control Hierarchy (Appearance 1.0 and later only)                                 */
  1270. /*--------------------------------------------------------------------------------------*/
  1271. #endif  /* CALL_NOT_IN_CARBON */
  1273. EXTERN_API( SInt32 )
  1274. SendControlMessage              (ControlRef             inControl,
  1275.                                  SInt16                 inMessage,
  1276.                                  SInt32                 inParam)                            THREEWORDINLINE(0x303C, 0xFFFE, 0xAA73);
  1278. EXTERN_API( OSErr )
  1279. DumpControlHierarchy            (WindowPtr              inWindow,
  1280.                                  const FSSpec *         inDumpFile)                         THREEWORDINLINE(0x303C, 0xFFFF, 0xAA73);
  1282. EXTERN_API( OSErr )
  1283. CreateRootControl               (WindowPtr              inWindow,
  1284.                                  ControlRef *           outControl)                         THREEWORDINLINE(0x303C, 0x0001, 0xAA73);
  1286. EXTERN_API( OSErr )
  1287. GetRootControl                  (WindowPtr              inWindow,
  1288.                                  ControlRef *           outControl)                         THREEWORDINLINE(0x303C, 0x0002, 0xAA73);
  1290. EXTERN_API( OSErr )
  1291. EmbedControl                    (ControlRef             inControl,
  1292.                                  ControlRef             inContainer)                        THREEWORDINLINE(0x303C, 0x0003, 0xAA73);
  1294. EXTERN_API( OSErr )
  1295. AutoEmbedControl                (ControlRef             inControl,
  1296.                                  WindowPtr              inWindow)                           THREEWORDINLINE(0x303C, 0x0004, 0xAA73);
  1298. EXTERN_API( OSErr )
  1299. GetSuperControl                 (ControlRef             inControl,
  1300.                                  ControlRef *           outParent)                          THREEWORDINLINE(0x303C, 0x0015, 0xAA73);
  1302. EXTERN_API( OSErr )
  1303. CountSubControls                (ControlRef             inControl,
  1304.                                  UInt16 *               outNumChildren)                     THREEWORDINLINE(0x303C, 0x0016, 0xAA73);
  1306. EXTERN_API( OSErr )
  1307. GetIndexedSubControl            (ControlRef             inControl,
  1308.                                  UInt16                 inIndex,
  1309.                                  ControlRef *           outSubControl)                      THREEWORDINLINE(0x303C, 0x0017, 0xAA73);
  1311. EXTERN_API( OSErr )
  1312. SetControlSupervisor            (ControlRef             inControl,
  1313.                                  ControlRef             inBoss)                             THREEWORDINLINE(0x303C, 0x001A, 0xAA73);
  1317. /*--------------------------------------------------------------------------------------*/
  1318. /*  o Keyboard Focus (available only with Appearance 1.0 and later)                     */
  1319. /*--------------------------------------------------------------------------------------*/
  1320. EXTERN_API( OSErr )
  1321. GetKeyboardFocus                (WindowPtr              inWindow,
  1322.                                  ControlRef *           outControl)                         THREEWORDINLINE(0x303C, 0x000D, 0xAA73);
  1324. EXTERN_API( OSErr )
  1325. SetKeyboardFocus                (WindowPtr              inWindow,
  1326.                                  ControlRef             inControl,
  1327.                                  ControlFocusPart       inPart)                             THREEWORDINLINE(0x303C, 0x000E, 0xAA73);
  1329. EXTERN_API( OSErr )
  1330. AdvanceKeyboardFocus            (WindowPtr              inWindow)                           THREEWORDINLINE(0x303C, 0x000F, 0xAA73);
  1332. EXTERN_API( OSErr )
  1333. ReverseKeyboardFocus            (WindowPtr              inWindow)                           THREEWORDINLINE(0x303C, 0x0010, 0xAA73);
  1335. EXTERN_API( OSErr )
  1336. ClearKeyboardFocus              (WindowPtr              inWindow)                           THREEWORDINLINE(0x303C, 0x0019, 0xAA73);
  1340. /*--------------------------------------------------------------------------------------*/
  1341. /*  o Control Data (available only with Appearance 1.0 and later)                       */
  1342. /*--------------------------------------------------------------------------------------*/
  1344. EXTERN_API( OSErr )
  1345. GetControlFeatures              (ControlRef             inControl,
  1346.                                  UInt32 *               outFeatures)                        THREEWORDINLINE(0x303C, 0x0011, 0xAA73);
  1348. EXTERN_API( OSErr )
  1349. SetControlData                  (ControlRef             inControl,
  1350.                                  ControlPartCode        inPart,
  1351.                                  ResType                inTagName,
  1352.                                  Size                   inSize,
  1353.                                  void *                 inData)                             THREEWORDINLINE(0x303C, 0x0012, 0xAA73);
  1355. EXTERN_API( OSErr )
  1356. GetControlData                  (ControlRef             inControl,
  1357.                                  ControlPartCode        inPart,
  1358.                                  ResType                inTagName,
  1359.                                  Size                   inBufferSize,
  1360.                                  void *                 inBuffer,
  1361.                                  Size *                 outActualSize)                      THREEWORDINLINE(0x303C, 0x0013, 0xAA73);
  1363. EXTERN_API( OSErr )
  1364. GetControlDataSize              (ControlRef             inControl,
  1365.                                  ControlPartCode        inPart,
  1366.                                  ResType                inTagName,
  1367.                                  Size *                 outMaxSize)                         THREEWORDINLINE(0x303C, 0x0014, 0xAA73);
  1370. /*--------------------------------------------------------------------------------------*/
  1371. /*  o Control Drag & Drop                                                               */
  1372. /*      Carbon only.                                                                    */
  1373. /*--------------------------------------------------------------------------------------*/
  1374. /* some simple redefinitions of the messages found in the Drag header*/
  1375. enum {
  1376.     kDragTrackingEnterControl   = kDragTrackingEnterWindow,
  1377.     kDragTrackingInControl      = kDragTrackingInWindow,
  1378.     kDragTrackingLeaveControl   = kDragTrackingLeaveWindow
  1379. };
  1381. EXTERN_API( OSStatus )
  1382. HandleControlDragTracking       (ControlRef             inControl,
  1383.                                  DragTrackingMessage    inMessage,
  1384.                                  DragReference          inDrag,
  1385.                                  Boolean *              outLikesDrag);
  1387. EXTERN_API( OSStatus )
  1388. HandleControlDragReceive        (ControlRef             inControl,
  1389.                                  DragReference          inDrag);
  1391. EXTERN_API( OSStatus )
  1392. SetControlDragTrackingEnabled   (ControlRef             theControl,
  1393.                                  Boolean                tracks);
  1395. EXTERN_API( OSStatus )
  1396. IsControlDragTrackingEnabled    (ControlRef             theControl,
  1397.                                  Boolean *              tracks);
  1399. EXTERN_API( OSStatus )
  1400. SetAutomaticControlDragTrackingEnabledForWindow (WindowPtr  theWindow,
  1401.                                  Boolean                tracks);
  1403. EXTERN_API( OSStatus )
  1404. IsAutomaticControlDragTrackingEnabledForWindow (WindowPtr  theWindow,
  1405.                                  Boolean *              tracks);
  1408. #if !TARGET_OS_MAC
  1409. /*--------------------------------------------------------------------------------------*/
  1410. /*  o QuickTime 3.0 Win32/unix notification mechanism                                   */
  1411. /*--------------------------------------------------------------------------------------*/
  1412. /* Proc used to notify window that something happened to the control*/
  1413. typedef CALLBACK_API_C( void , ControlNotificationProcPtr )(WindowPtr theWindow, ControlRef theControl, ControlNotification notification, long param1, long param2);
  1414. /*
  1415.    Proc used to prefilter events before handled by control.  A client of a control calls
  1416.    CTRLSetPreFilterProc() to have the control call this proc before handling the event.
  1417.    If the proc returns TRUE, the control can go ahead and handle the event.
  1418. */
  1419. typedef CALLBACK_API_C( Boolean , PreFilterEventProc )(ControlRef theControl, EventRecord *theEvent);
  1420. #if CALL_NOT_IN_CARBON
  1421. EXTERN_API_C( long )
  1422. GetControlComponentInstance     (ControlRef             theControl);
  1424. EXTERN_API_C( ControlRef )
  1425. GetControlHandleFromCookie      (long                   cookie);
  1427. EXTERN_API_C( void )
  1428. SetControlDefProc               (short                  resID,
  1429.                                  ControlDefProcPtr      proc);
  1431. #endif  /* CALL_NOT_IN_CARBON */
  1434. typedef ControlNotificationProcPtr      ControlNotificationUPP;
  1435. #endif  /* !TARGET_OS_MAC */
  1437. /*--------------------------------------------------------------------------------------*/
  1438. /*  o C Glue                                                                            */
  1439. /*--------------------------------------------------------------------------------------*/
  1440. #if CALL_NOT_IN_CARBON
  1441. #if CALL_NOT_IN_CARBON
  1442. EXTERN_API_C( void )
  1443. dragcontrol                     (ControlRef             theControl,
  1444.                                  Point *                startPt,
  1445.                                  const Rect *           limitRect,
  1446.                                  const Rect *           slopRect,
  1447.                                  short                  axis);
  1449. EXTERN_API_C( ControlRef )
  1450. newcontrol                      (WindowPtr              theWindow,
  1451.                                  const Rect *           boundsRect,
  1452.                                  const char *           title,
  1453.                                  Boolean                visible,
  1454.                                  short                  value,
  1455.                                  short                  min,
  1456.                                  short                  max,
  1457.                                  short                  procID,
  1458.                                  long                   refCon);
  1460. EXTERN_API_C( short )
  1461. findcontrol                     (Point *                thePoint,
  1462.                                  WindowPtr              theWindow,
  1463.                                  ControlRef *           theControl);
  1465. EXTERN_API_C( void )
  1466. getcontroltitle                 (ControlRef             theControl,
  1467.                                  char *                 title);
  1469. EXTERN_API_C( void )
  1470. setcontroltitle                 (ControlRef             theControl,
  1471.                                  const char *           title);
  1473. EXTERN_API_C( short )
  1474. trackcontrol                    (ControlRef             theControl,
  1475.                                  Point *                thePoint,
  1476.                                  ControlActionUPP       actionProc);
  1478. EXTERN_API_C( short )
  1479. testcontrol                     (ControlRef             theControl,
  1480.                                  Point *                thePt);
  1482. #endif  /* CALL_NOT_IN_CARBON */
  1484. #endif  /* CALL_NOT_IN_CARBON */
  1486. #if OLDROUTINENAMES
  1487. /*--------------------------------------------------------------------------------------*/
  1488. /*  o OLDROUTINENAMES                                                                   */
  1489. /*--------------------------------------------------------------------------------------*/
  1490. enum {
  1491.     useWFont                    = kControlUsesOwningWindowsFontVariant
  1492. };
  1494. enum {
  1495.     inThumb                     = kControlIndicatorPart,
  1496.     kNoHiliteControlPart        = kControlNoPart,
  1497.     kInIndicatorControlPart     = kControlIndicatorPart,
  1498.     kReservedControlPart        = kControlDisabledPart,
  1499.     kControlInactiveControlPart = kControlInactivePart
  1500. };
  1503. #define SetCTitle(theControl, title) SetControlTitle(theControl, title)
  1504. #define GetCTitle(theControl, title) GetControlTitle(theControl, title)
  1505. #define UpdtControl(theWindow, updateRgn) UpdateControls(theWindow, updateRgn)
  1506. #define SetCtlValue(theControl, theValue) SetControlValue(theControl, theValue)
  1507. #define GetCtlValue(theControl) GetControlValue(theControl)
  1508. #define SetCtlMin(theControl, minValue) SetControlMinimum(theControl, minValue)
  1509. #define GetCtlMin(theControl) GetControlMinimum(theControl)
  1510. #define SetCtlMax(theControl, maxValue) SetControlMaximum(theControl, maxValue)
  1511. #define GetCtlMax(theControl) GetControlMaximum(theControl)
  1512. #define GetAuxCtl(theControl, acHndl) GetAuxiliaryControlRecord(theControl, acHndl)
  1513. #define SetCRefCon(theControl, data) SetControlReference(theControl, data)
  1514. #define GetCRefCon(theControl) GetControlReference(theControl)
  1515. #define SetCtlAction(theControl, actionProc) SetControlAction(theControl, actionProc)
  1516. #define GetCtlAction(theControl) GetControlAction(theControl)
  1517. #define SetCtlColor(theControl, newColorTable) SetControlColor(theControl, newColorTable)
  1518. #define GetCVariant(theControl) GetControlVariant(theControl)
  1519. #define getctitle(theControl, title) getcontroltitle(theControl, title)
  1520. #define setctitle(theControl, title) setcontroltitle(theControl, title)
  1521. #endif  /* OLDROUTINENAMES */
  1523. #if ACCESSOR_CALLS_ARE_FUNCTIONS
  1524. /* Getters */
  1525. EXTERN_API( Rect *)
  1526. GetControlBounds                (ControlRef             control,
  1527.                                  Rect *                 bounds);
  1529. EXTERN_API( Boolean )
  1530. IsControlHilited                (ControlRef             control);
  1532. EXTERN_API( UInt16 )
  1533. GetControlHilite                (ControlRef             control);
  1535. EXTERN_API( WindowPtr )
  1536. GetControlOwner                 (ControlRef             control);
  1538. EXTERN_API( Handle )
  1539. GetControlDataHandle            (ControlRef             control);
  1541. EXTERN_API( MenuHandle )
  1542. GetControlPopupMenuHandle       (ControlRef             control);
  1544. EXTERN_API( short )
  1545. GetControlPopupMenuID           (ControlRef             control);
  1547. /* Setters */
  1548. EXTERN_API( void )
  1549. SetControlDataHandle            (ControlRef             control,
  1550.                                  Handle                 dataHandle);
  1552. EXTERN_API( void )
  1553. SetControlBounds                (ControlRef             control,
  1554.                                  const Rect *           bounds);
  1556. EXTERN_API( void )
  1557. SetControlPopupMenuHandle       (ControlRef             control,
  1558.                                  MenuHandle             popupMenu);
  1560. EXTERN_API( void )
  1561. SetControlPopupMenuID           (ControlRef             control,
  1562.                                  short                  menuID);
  1564. #endif  /* ACCESSOR_CALLS_ARE_FUNCTIONS */
  1566. #if !OPAQUE_TOOLBOX_STRUCTS && !ACCESSOR_CALLS_ARE_FUNCTIONS
  1567. #define GetControlListFromWindow(theWindow)     ( *(ControlRef *) (((UInt8 *) theWindow) + sizeof(GrafPort) + 0x20))
  1568. #define GetControlOwningWindowControlList(theWindow)        ( *(ControlRef *) (((UInt8 *) theWindow) + sizeof(GrafPort) + 0x20))
  1569. #endif  /* !OPAQUE_TOOLBOX_STRUCTS && !ACCESSOR_CALLS_ARE_FUNCTIONS */
  1573. #if PRAGMA_STRUCT_ALIGN
  1574.     #pragma options align=reset
  1575. #elif PRAGMA_STRUCT_PACKPUSH
  1576.     #pragma pack(pop)
  1577. #elif PRAGMA_STRUCT_PACK
  1578.     #pragma pack()
  1579. #endif
  1581. #ifdef PRAGMA_IMPORT_OFF
  1582. #pragma import off
  1583. #elif PRAGMA_IMPORT
  1584. #pragma import reset
  1585. #endif
  1587. #ifdef __cplusplus
  1588. }
  1589. #endif
  1591. #endif /* __CONTROLS__ */