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

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

多媒体编程

开发平台：

Visual C++

Balloons.h：源码内容
  1. /*
  2.      File:       Balloons.h
  3.  
  4.      Contains:   Balloon Help Package Interfaces.
  5.  
  6.      Version:    Technology: System 7.0
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1990-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 __BALLOONS__
  18. #define __BALLOONS__
  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 __MACERRORS__
  37. #include "MacErrors.h"
  38. #endif
  43. #if PRAGMA_ONCE
  44. #pragma once
  45. #endif
  47. #ifdef __cplusplus
  48. extern "C" {
  49. #endif
  51. #if PRAGMA_IMPORT
  52. #pragma import on
  53. #endif
  55. #if PRAGMA_STRUCT_ALIGN
  56.     #pragma options align=mac68k
  57. #elif PRAGMA_STRUCT_PACKPUSH
  58.     #pragma pack(push, 2)
  59. #elif PRAGMA_STRUCT_PACK
  60.     #pragma pack(2)
  61. #endif
  63. /*
  64.    Carbon clients should use MacHelp. The definitions below will NOT work for Carbon and
  65.    are only defined for those files that need to build pre-Carbon applications.
  66. */
  67. /* o.constants*/
  70. typedef SInt16 BalloonVariant;
  71. enum {
  72.     kTopLeftTipPointsLeftVariant = 0,
  73.     kTopLeftTipPointsUpVariant  = 1,
  74.     kTopRightTipPointsUpVariant = 2,
  75.     kTopRightTipPointsRightVariant = 3,
  76.     kBottomRightTipPointsRightVariant = 4,
  77.     kBottomRightTipPointsDownVariant = 5,
  78.     kBottomLeftTipPointsDownVariant = 6,
  79.     kBottomLeftTipPointsLeftVariant = 7,
  80.     kBalloonVariantCount        = 8
  81. };
  84. #ifndef __MACHELP__
  85. enum {
  86.     hmBalloonHelpVersion        = 0x0002                        /* The real version of the Help Manager */
  87. };
  89. #endif  /* !defined(__MACHELP__) */
  91. enum {
  92.     kHMHelpMenuID               = -16490,                       /* Resource ID and menu ID of help menu */
  93.     kHMAboutHelpItem            = 1,                            /* help menu item number of About Balloon Help... */
  94.     kHMShowBalloonsItem         = 3                             /* help menu item number of Show/Hide Balloons */
  95. };
  97. enum {
  98.     kHMHelpID                   = -5696,                        /* ID of various Help Mgr package resources (in Pack14 range) */
  99.     kBalloonWDEFID              = 126                           /* Resource ID of the WDEF proc used in standard balloons */
  100. };
  102. enum {
  103.                                                                 /* Dialog item template type constant */
  104.     helpItem                    = 1                             /* key value in DITL template that corresponds to the help item */
  105. };
  107. enum {
  108.                                                                 /* Options for Help Manager resources in 'hmnu', 'hdlg', 'hrct', 'hovr', & 'hfdr' resources */
  109.     hmDefaultOptions            = 0,                            /* default options for help manager resources */
  110.     hmUseSubID                  = 1,                            /* treat resID's in resources as subID's of driver base ID (for Desk Accessories) */
  111.     hmAbsoluteCoords            = 2                             /* ignore window port origin and treat rectangles as absolute coords (local to window) */
  112. };
  114. enum {
  115.     hmSaveBitsNoWindow          = 4,                            /* don't create a window, just blast bits on screen. No update event is generated */
  116.     hmSaveBitsWindow            = 8,                            /* create a window, but restore bits behind window when window goes away & generate update event */
  117.     hmMatchInTitle              = 16                            /* for hwin resources, match string anywhere in window title string */
  118. };
  120. enum {
  121.                                                                 /* Constants for Help Types in 'hmnu', 'hdlg', 'hrct', 'hovr', & 'hfdr' resources */
  122.     kHMStringItem               = 1,                            /* pstring used in resource */
  123.     kHMPictItem                 = 2,                            /* 'PICT' ResID used in resource */
  124.     kHMStringResItem            = 3,                            /* 'STR#' ResID & index used in resource */
  125.     kHMTEResItem                = 6,                            /* Styled Text Edit ResID used in resource ('TEXT' & 'styl') */
  126.     kHMSTRResItem               = 7,                            /* 'STR ' ResID used in resource */
  127.     kHMSkipItem                 = 256,                          /* don't display a balloon */
  128.     kHMCompareItem              = 512,                          /* Compare pstring in menu item w/ PString in resource item ('hmnu' only) */
  129.     kHMNamedResourceItem        = 1024,                         /* Use pstring in menu item to get 'STR#', 'PICT', or 'STR ' resource ('hmnu' only) */
  130.     kHMTrackCntlItem            = 2048                          /* Reserved */
  131. };
  133. enum {
  134.                                                                 /* Constants for hmmHelpType's when filling out HMMessageRecord */
  135.     khmmString                  = 1,                            /* help message contains a PString */
  136.     khmmPict                    = 2,                            /* help message contains a resource ID to a 'PICT' resource */
  137.     khmmStringRes               = 3,                            /* help message contains a res ID & index to a 'STR#' resource */
  138.     khmmTEHandle                = 4,                            /* help message contains a Text Edit handle */
  139.     khmmPictHandle              = 5,                            /* help message contains a Picture handle */
  140.     khmmTERes                   = 6,                            /* help message contains a res ID to 'TEXT' & 'styl' resources */
  141.     khmmSTRRes                  = 7,                            /* help message contains a res ID to a 'STR ' resource */
  142.     kHMEnabledItem              = 0                             /* item is enabled, but not checked or control value = 0 */
  143. };
  145. enum {
  146.                                                                 /* ResTypes for Styled TE Handles in Resources */
  147.     kHMTETextResType            = FOUR_CHAR_CODE('TEXT'),       /* Resource Type of text data for styled TE record w/o style info */
  148.     kHMTEStyleResType           = FOUR_CHAR_CODE('styl')        /* Resource Type of style information for styled TE record */
  149. };
  151. enum {
  152.     kHMDisabledItem             = 1,                            /* item is disabled, grayed in menus or disabled in dialogs */
  153.     kHMCheckedItem              = 2,                            /* item is enabled, and checked or control value = 1 */
  154.     kHMOtherItem                = 3,                            /* item is enabled, and control value > 1 */
  155.                                                                 /* Method parameters to pass to HMShowBalloon */
  156.     kHMRegularWindow            = 0,                            /* Create a regular window floating above all windows */
  157.     kHMSaveBitsNoWindow         = 1,                            /* Just save the bits and draw (for MDEF calls) */
  158.     kHMSaveBitsWindow           = 2                             /* Regular window, save bits behind, AND generate update event */
  159. };
  161. enum {
  162.                                                                 /* Resource Types for whichType parameter used when extracting 'hmnu' & 'hdlg' messages */
  163.     kHMMenuResType              = FOUR_CHAR_CODE('hmnu'),       /* ResType of help resource for supporting menus */
  164.     kHMDialogResType            = FOUR_CHAR_CODE('hdlg'),       /* ResType of help resource for supporting dialogs */
  165.     kHMWindListResType          = FOUR_CHAR_CODE('hwin'),       /* ResType of help resource for supporting windows */
  166.     kHMRectListResType          = FOUR_CHAR_CODE('hrct'),       /* ResType of help resource for rectangles in windows */
  167.     kHMOverrideResType          = FOUR_CHAR_CODE('hovr'),       /* ResType of help resource for overriding system balloons */
  168.     kHMFinderApplResType        = FOUR_CHAR_CODE('hfdr')        /* ResType of help resource for custom balloon in Finder */
  169. };
  171. #ifndef __MACHELP__
  173. struct HMStringResType {
  174.     short                           hmmResID;
  175.     short                           hmmIndex;
  176. };
  177. typedef struct HMStringResType          HMStringResType;
  178. #endif  /* !defined(__MACHELP__) */
  181. struct HMMessageRecord {
  182.     SInt16                          hmmHelpType;
  183.     union {
  184.         Str255                          hmmString;
  185.         SInt16                          hmmPict;
  186.         TEHandle                        hmmTEHandle;
  187.         HMStringResType                 hmmStringRes;
  188.         SInt16                          hmmPictRes;
  189.         PicHandle                       hmmPictHandle;
  190.         SInt16                          hmmTERes;
  191.         SInt16                          hmmSTRRes;
  192.     }                                 u;
  193. };
  194. typedef struct HMMessageRecord          HMMessageRecord;
  196. typedef HMMessageRecord *               HMMessageRecPtr;
  197. typedef CALLBACK_API( OSErr , TipFunctionProcPtr )(Point tip, RgnHandle structure, Rect *r, BalloonVariant *balloonVariant);
  198. typedef STACK_UPP_TYPE(TipFunctionProcPtr)                      TipFunctionUPP;
  199. #if OPAQUE_UPP_TYPES
  200. #if CALL_NOT_IN_CARBON
  201.     EXTERN_API(TipFunctionUPP)
  202.     NewTipFunctionUPP              (TipFunctionProcPtr      userRoutine);
  204.     EXTERN_API(void)
  205.     DisposeTipFunctionUPP          (TipFunctionUPP          userUPP);
  207.     EXTERN_API(OSErr)
  208.     InvokeTipFunctionUPP           (Point                   tip,
  209.                                     RgnHandle               structure,
  210.                                     Rect *                  r,
  211.                                     BalloonVariant *        balloonVariant,
  212.                                     TipFunctionUPP          userUPP);
  214. #endif  /* CALL_NOT_IN_CARBON */
  216. #else
  217.     enum { uppTipFunctionProcInfo = 0x00003FE0 };                   /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */
  218.     #define NewTipFunctionUPP(userRoutine)                          (TipFunctionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppTipFunctionProcInfo, GetCurrentArchitecture())
  219.     #define DisposeTipFunctionUPP(userUPP)                          DisposeRoutineDescriptor(userUPP)
  220.     #define InvokeTipFunctionUPP(tip, structure, r, balloonVariant, userUPP)  (OSErr)CALL_FOUR_PARAMETER_UPP((userUPP), uppTipFunctionProcInfo, (tip), (structure), (r), (balloonVariant))
  221. #endif
  222. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  223. #define NewTipFunctionProc(userRoutine)                         NewTipFunctionUPP(userRoutine)
  224. #define CallTipFunctionProc(userRoutine, tip, structure, r, balloonVariant) InvokeTipFunctionUPP(tip, structure, r, balloonVariant, userRoutine)
  225. /*  Public Interfaces  */
  226. #if CALL_NOT_IN_CARBON
  227. EXTERN_API( OSErr )
  228. HMGetHelpMenuHandle             (MenuHandle *           mh)                                 THREEWORDINLINE(0x303C, 0x0200, 0xA830);
  230. EXTERN_API( OSErr )
  231. HMShowBalloon                   (const HMMessageRecord * inHelpMessage,
  232.                                  Point                  inTip,
  233.                                  Rect *                 inHotRect, /* can be NULL */
  234.                                  TipFunctionUPP         inTipProc,
  235.                                  SInt16                 inWindowProcID,
  236.                                  BalloonVariant         inBalloonVariant,
  237.                                  SInt16                 inMethod)                           THREEWORDINLINE(0x303C, 0x0B01, 0xA830);
  239. EXTERN_API( OSErr )
  240. HMShowMenuBalloon               (SInt16                 itemNum,
  241.                                  SInt16                 itemMenuID,
  242.                                  SInt32                 itemFlags,
  243.                                  SInt32                 itemReserved,
  244.                                  Point                  tip,
  245.                                  Rect *                 alternateRect, /* can be NULL */
  246.                                  TipFunctionUPP         tipProc,
  247.                                  SInt16                 theProc,
  248.                                  BalloonVariant         balloonVariant)                     THREEWORDINLINE(0x303C, 0x0E05, 0xA830);
  250. EXTERN_API( OSErr )
  251. HMRemoveBalloon                 (void)                                                      THREEWORDINLINE(0x303C, 0x0002, 0xA830);
  253. EXTERN_API( OSErr )
  254. HMGetIndHelpMsg                 (ResType                inWhichResType,
  255.                                  SInt16                 inWhichResID,
  256.                                  SInt16                 inMessageIndex,
  257.                                  SInt16                 inMessageState,
  258.                                  UInt32 *               outOptions,
  259.                                  Point *                outTip,
  260.                                  Rect *                 outHotRect,
  261.                                  SInt16 *               outWindowProcID,
  262.                                  BalloonVariant *       outBalloonVariant,
  263.                                  HMMessageRecord *      outHelpMessage,
  264.                                  SInt16 *               outMessageCount)                    THREEWORDINLINE(0x303C, 0x1306, 0xA830);
  266. EXTERN_API( Boolean )
  267. HMIsBalloon                     (void)                                                      THREEWORDINLINE(0x303C, 0x0007, 0xA830);
  269. EXTERN_API( Boolean )
  270. HMGetBalloons                   (void)                                                      THREEWORDINLINE(0x303C, 0x0003, 0xA830);
  272. EXTERN_API( OSErr )
  273. HMSetBalloons                   (Boolean                flag)                               THREEWORDINLINE(0x303C, 0x0104, 0xA830);
  275. EXTERN_API( OSErr )
  276. HMSetFont                       (SInt16                 font)                               THREEWORDINLINE(0x303C, 0x0108, 0xA830);
  278. EXTERN_API( OSErr )
  279. HMSetFontSize                   (UInt16                 fontSize)                           THREEWORDINLINE(0x303C, 0x0109, 0xA830);
  281. EXTERN_API( OSErr )
  282. HMGetFont                       (SInt16 *               font)                               THREEWORDINLINE(0x303C, 0x020A, 0xA830);
  284. EXTERN_API( OSErr )
  285. HMGetFontSize                   (UInt16 *               fontSize)                           THREEWORDINLINE(0x303C, 0x020B, 0xA830);
  287. EXTERN_API( OSErr )
  288. HMSetDialogResID                (SInt16                 resID)                              THREEWORDINLINE(0x303C, 0x010C, 0xA830);
  290. EXTERN_API( OSErr )
  291. HMSetMenuResID                  (SInt16                 menuID,
  292.                                  SInt16                 resID)                              THREEWORDINLINE(0x303C, 0x020D, 0xA830);
  294. EXTERN_API( OSErr )
  295. HMBalloonRect                   (const HMMessageRecord * inMessage,
  296.                                  Rect *                 outRect)                            THREEWORDINLINE(0x303C, 0x040E, 0xA830);
  298. EXTERN_API( OSErr )
  299. HMBalloonPict                   (const HMMessageRecord * inMessage,
  300.                                  PicHandle *            outPict)                            THREEWORDINLINE(0x303C, 0x040F, 0xA830);
  302. EXTERN_API( OSErr )
  303. HMScanTemplateItems             (SInt16                 whichID,
  304.                                  SInt16                 whichResFile,
  305.                                  ResType                whichType)                          THREEWORDINLINE(0x303C, 0x0410, 0xA830);
  307. EXTERN_API( OSErr )
  308. HMExtractHelpMsg                (ResType                inType,
  309.                                  SInt16                 inResID,
  310.                                  SInt16                 inMessageIndex,
  311.                                  SInt16                 inMessageState,
  312.                                  HMMessageRecord *      outMessage)                         THREEWORDINLINE(0x303C, 0x0711, 0xA830);
  314. EXTERN_API( OSErr )
  315. HMGetDialogResID                (SInt16 *               resID)                              THREEWORDINLINE(0x303C, 0x0213, 0xA830);
  317. EXTERN_API( OSErr )
  318. HMGetMenuResID                  (SInt16                 menuID,
  319.                                  SInt16 *               resID)                              THREEWORDINLINE(0x303C, 0x0314, 0xA830);
  321. EXTERN_API( OSErr )
  322. HMGetBalloonWindow              (WindowPtr *            window)                             THREEWORDINLINE(0x303C, 0x0215, 0xA830);
  324. #endif  /* CALL_NOT_IN_CARBON */
  330. #if PRAGMA_STRUCT_ALIGN
  331.     #pragma options align=reset
  332. #elif PRAGMA_STRUCT_PACKPUSH
  333.     #pragma pack(pop)
  334. #elif PRAGMA_STRUCT_PACK
  335.     #pragma pack()
  336. #endif
  338. #ifdef PRAGMA_IMPORT_OFF
  339. #pragma import off
  340. #elif PRAGMA_IMPORT
  341. #pragma import reset
  342. #endif
  344. #ifdef __cplusplus
  345. }
  346. #endif
  348. #endif /* __BALLOONS__ */