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

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

多媒体编程

开发平台：

Visual C++

Dialogs.h：源码内容
  1. /*
  2.      File:       Dialogs.h
  3.  
  4.      Contains:   Dialog 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 __DIALOGS__
  18. #define __DIALOGS__
  20. #ifndef __MACTYPES__
  21. #include "MacTypes.h"
  22. #endif
  24. #ifndef __MIXEDMODE__
  25. #include "MixedMode.h"
  26. #endif
  28. #ifndef __EVENTS__
  29. #include "Events.h"
  30. #endif
  32. #ifndef __MACWINDOWS__
  33. #include "MacWindows.h"
  34. #endif
  36. #ifndef __TEXTEDIT__
  37. #include "TextEdit.h"
  38. #endif
  40. #ifndef __CONTROLS__
  41. #include "Controls.h"
  42. #endif
  44. #ifndef __MACERRORS__
  45. #include "MacErrors.h"
  46. #endif
  51. #if PRAGMA_ONCE
  52. #pragma once
  53. #endif
  55. #ifdef __cplusplus
  56. extern "C" {
  57. #endif
  59. #if PRAGMA_IMPORT
  60. #pragma import on
  61. #endif
  63. #if PRAGMA_STRUCT_ALIGN
  64.     #pragma options align=mac68k
  65. #elif PRAGMA_STRUCT_PACKPUSH
  66.     #pragma pack(push, 2)
  67. #elif PRAGMA_STRUCT_PACK
  68.     #pragma pack(2)
  69. #endif
  71. enum {
  72.                                                                 /* new, more standard names for dialog item types*/
  73.     kControlDialogItem          = 4,
  74.     kButtonDialogItem           = kControlDialogItem | 0,
  75.     kCheckBoxDialogItem         = kControlDialogItem | 1,
  76.     kRadioButtonDialogItem      = kControlDialogItem | 2,
  77.     kResourceControlDialogItem  = kControlDialogItem | 3,
  78.     kStaticTextDialogItem       = 8,
  79.     kEditTextDialogItem         = 16,
  80.     kIconDialogItem             = 32,
  81.     kPictureDialogItem          = 64,
  82.     kUserDialogItem             = 0,
  83.     kItemDisableBit             = 128
  84. };
  86. enum {
  87.                                                                 /* old names for dialog item types*/
  88.     ctrlItem                    = 4,
  89.     btnCtrl                     = 0,
  90.     chkCtrl                     = 1,
  91.     radCtrl                     = 2,
  92.     resCtrl                     = 3,
  93.     statText                    = 8,
  94.     editText                    = 16,
  95.     iconItem                    = 32,
  96.     picItem                     = 64,
  97.     userItem                    = 0,
  98.     itemDisable                 = 128
  99. };
  101. enum {
  102.                                                                 /* standard dialog item numbers*/
  103.     kStdOkItemIndex             = 1,
  104.     kStdCancelItemIndex         = 2,                            /* old names*/
  105.     ok                          = kStdOkItemIndex,
  106.     cancel                      = kStdCancelItemIndex
  107. };
  109. enum {
  110.                                                                 /* standard icon resource id's    */
  111.     kStopIcon                   = 0,
  112.     kNoteIcon                   = 1,
  113.     kCautionIcon                = 2,                            /* old names*/
  114.     stopIcon                    = kStopIcon,
  115.     noteIcon                    = kNoteIcon,
  116.     cautionIcon                 = kCautionIcon
  117. };
  122. #if OLDROUTINENAMES
  123. /*
  124.    These constants lived briefly on ETO 16.  They suggest
  125.    that there is only one index you can use for the OK 
  126.    item, which is not true.  You can put the ok item 
  127.    anywhere you want in the DITL.
  128. */
  129. enum {
  130.     kOkItemIndex                = 1,
  131.     kCancelItemIndex            = 2
  132. };
  134. #endif  /* OLDROUTINENAMES */
  136. /*  Dialog Item List Manipulation Constants */
  137. typedef SInt16                          DITLMethod;
  138. enum {
  139.     overlayDITL                 = 0,
  140.     appendDITLRight             = 1,
  141.     appendDITLBottom            = 2
  142. };
  144. typedef SInt16                          StageList;
  145. /* DialogRef is obsolete. Use DialogPtr instead.*/
  146. typedef DialogPtr                       DialogRef;
  147. #if !OPAQUE_TOOLBOX_STRUCTS
  149. struct DialogRecord {
  150.     WindowRecord                    window;
  151.     Handle                          items;
  152.     TEHandle                        textH;
  153.     SInt16                          editField;
  154.     SInt16                          editOpen;
  155.     SInt16                          aDefItem;
  156. };
  157. typedef struct DialogRecord             DialogRecord;
  159. typedef DialogRecord *                  DialogPeek;
  160. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  163. struct DialogTemplate {
  164.     Rect                            boundsRect;
  165.     SInt16                          procID;
  166.     Boolean                         visible;
  167.     Boolean                         filler1;
  168.     Boolean                         goAwayFlag;
  169.     Boolean                         filler2;
  170.     SInt32                          refCon;
  171.     SInt16                          itemsID;
  172.     Str255                          title;
  173. };
  174. typedef struct DialogTemplate           DialogTemplate;
  176. typedef DialogTemplate *                DialogTPtr;
  177. typedef DialogTPtr *                    DialogTHndl;
  179. struct AlertTemplate {
  180.     Rect                            boundsRect;
  181.     SInt16                          itemsID;
  182.     StageList                       stages;
  183. };
  184. typedef struct AlertTemplate            AlertTemplate;
  186. typedef AlertTemplate *                 AlertTPtr;
  187. typedef AlertTPtr *                     AlertTHndl;
  188. /* new type abstractions for the dialog manager */
  189. typedef SInt16                          DialogItemIndexZeroBased;
  190. typedef SInt16                          DialogItemIndex;
  191. typedef SInt16                          DialogItemType;
  192. /* dialog manager callbacks */
  193. typedef CALLBACK_API( void , SoundProcPtr )(SInt16 soundNumber);
  194. typedef CALLBACK_API( Boolean , ModalFilterProcPtr )(DialogPtr theDialog, EventRecord *theEvent, DialogItemIndex *itemHit);
  195. typedef CALLBACK_API( void , UserItemProcPtr )(DialogPtr theDialog, DialogItemIndex itemNo);
  196. typedef STACK_UPP_TYPE(SoundProcPtr)                            SoundUPP;
  197. typedef STACK_UPP_TYPE(ModalFilterProcPtr)                      ModalFilterUPP;
  198. typedef STACK_UPP_TYPE(UserItemProcPtr)                         UserItemUPP;
  199. #if OPAQUE_UPP_TYPES
  200. #if CALL_NOT_IN_CARBON
  201.     EXTERN_API(SoundUPP)
  202.     NewSoundUPP                    (SoundProcPtr            userRoutine);
  204. #endif  /* CALL_NOT_IN_CARBON */
  206.     EXTERN_API(ModalFilterUPP)
  207.     NewModalFilterUPP              (ModalFilterProcPtr      userRoutine);
  209.     EXTERN_API(UserItemUPP)
  210.     NewUserItemUPP                 (UserItemProcPtr         userRoutine);
  212. #if CALL_NOT_IN_CARBON
  213.     EXTERN_API(void)
  214.     DisposeSoundUPP                (SoundUPP                userUPP);
  216. #endif  /* CALL_NOT_IN_CARBON */
  218.     EXTERN_API(void)
  219.     DisposeModalFilterUPP          (ModalFilterUPP          userUPP);
  221.     EXTERN_API(void)
  222.     DisposeUserItemUPP             (UserItemUPP             userUPP);
  224. #if CALL_NOT_IN_CARBON
  225.     EXTERN_API(void)
  226.     InvokeSoundUPP                 (SInt16                  soundNumber,
  227.                                     SoundUPP                userUPP);
  229. #endif  /* CALL_NOT_IN_CARBON */
  231.     EXTERN_API(Boolean)
  232.     InvokeModalFilterUPP           (DialogPtr               theDialog,
  233.                                     EventRecord *           theEvent,
  234.                                     DialogItemIndex *       itemHit,
  235.                                     ModalFilterUPP          userUPP);
  237.     EXTERN_API(void)
  238.     InvokeUserItemUPP              (DialogPtr               theDialog,
  239.                                     DialogItemIndex         itemNo,
  240.                                     UserItemUPP             userUPP);
  242. #else
  243.     enum { uppSoundProcInfo = 0x00000080 };                         /* pascal no_return_value Func(2_bytes) */
  244.     enum { uppModalFilterProcInfo = 0x00000FD0 };                   /* pascal 1_byte Func(4_bytes, 4_bytes, 4_bytes) */
  245.     enum { uppUserItemProcInfo = 0x000002C0 };                      /* pascal no_return_value Func(4_bytes, 2_bytes) */
  246.     #define NewSoundUPP(userRoutine)                                (SoundUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppSoundProcInfo, GetCurrentArchitecture())
  247.     #define NewModalFilterUPP(userRoutine)                          (ModalFilterUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppModalFilterProcInfo, GetCurrentArchitecture())
  248.     #define NewUserItemUPP(userRoutine)                             (UserItemUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppUserItemProcInfo, GetCurrentArchitecture())
  249.     #define DisposeSoundUPP(userUPP)                                DisposeRoutineDescriptor(userUPP)
  250.     #define DisposeModalFilterUPP(userUPP)                          DisposeRoutineDescriptor(userUPP)
  251.     #define DisposeUserItemUPP(userUPP)                             DisposeRoutineDescriptor(userUPP)
  252.     #define InvokeSoundUPP(soundNumber, userUPP)                    CALL_ONE_PARAMETER_UPP((userUPP), uppSoundProcInfo, (soundNumber))
  253.     #define InvokeModalFilterUPP(theDialog, theEvent, itemHit, userUPP)  (Boolean)CALL_THREE_PARAMETER_UPP((userUPP), uppModalFilterProcInfo, (theDialog), (theEvent), (itemHit))
  254.     #define InvokeUserItemUPP(theDialog, itemNo, userUPP)           CALL_TWO_PARAMETER_UPP((userUPP), uppUserItemProcInfo, (theDialog), (itemNo))
  255. #endif
  256. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  257. #define NewSoundProc(userRoutine)                               NewSoundUPP(userRoutine)
  258. #define NewModalFilterProc(userRoutine)                         NewModalFilterUPP(userRoutine)
  259. #define NewUserItemProc(userRoutine)                            NewUserItemUPP(userRoutine)
  260. #define CallSoundProc(userRoutine, soundNumber)                 InvokeSoundUPP(soundNumber, userRoutine)
  261. #define CallModalFilterProc(userRoutine, theDialog, theEvent, itemHit) InvokeModalFilterUPP(theDialog, theEvent, itemHit, userRoutine)
  262. #define CallUserItemProc(userRoutine, theDialog, itemNo)        InvokeUserItemUPP(theDialog, itemNo, userRoutine)
  264. #if !TARGET_OS_MAC
  265. /* QuickTime 3.0 */
  266. typedef CALLBACK_API_C( void , QTModelessCallbackProcPtr )(EventRecord *theEvent, DialogPtr theDialog, DialogItemIndex itemHit);
  267. #if CALL_NOT_IN_CARBON
  268. EXTERN_API( void )
  269. SetModelessDialogCallbackProc   (DialogPtr              theDialog,
  270.                                  QTModelessCallbackProcPtr  callbackProc);
  272. #endif  /* CALL_NOT_IN_CARBON */
  274. typedef QTModelessCallbackProcPtr       QTModelessCallbackUPP;
  275. #if CALL_NOT_IN_CARBON
  276. EXTERN_API( OSErr )
  277. GetDialogControlNotificationProc (void *                theProc);
  279. EXTERN_API( void )
  280. SetDialogMovableModal           (DialogPtr              theDialog);
  282. EXTERN_API( void *)
  283. GetDialogParent                 (DialogPtr              theDialog);
  285. #endif  /* CALL_NOT_IN_CARBON */
  287. #endif  /* !TARGET_OS_MAC */
  289. /*
  290.   ---------------------------------------------------------------------------------------------------------
  291.     o Following types are valid with Appearance 1.0 and later
  292.   ---------------------------------------------------------------------------------------------------------
  293. */
  294. enum {
  295.                                                                 /* Alert types to pass into StandardAlert */
  296.     kAlertStopAlert             = 0,
  297.     kAlertNoteAlert             = 1,
  298.     kAlertCautionAlert          = 2,
  299.     kAlertPlainAlert            = 3
  300. };
  302. typedef SInt16                          AlertType;
  303. enum {
  304.     kAlertDefaultOKText         = -1,                           /* "OK"*/
  305.     kAlertDefaultCancelText     = -1,                           /* "Cancel"*/
  306.     kAlertDefaultOtherText      = -1                            /* "Don't Save"*/
  307. };
  309. /* StandardAlert alert button numbers */
  310. enum {
  311.     kAlertStdAlertOKButton      = 1,
  312.     kAlertStdAlertCancelButton  = 2,
  313.     kAlertStdAlertOtherButton   = 3,
  314.     kAlertStdAlertHelpButton    = 4
  315. };
  317. enum {
  318.                                                                 /* Dialog Flags for use in NewFeaturesDialog or dlgx resource */
  319.     kDialogFlagsUseThemeBackground = (1 << 0),
  320.     kDialogFlagsUseControlHierarchy = (1 << 1),
  321.     kDialogFlagsHandleMovableModal = (1 << 2),
  322.     kDialogFlagsUseThemeControls = (1 << 3)
  323. };
  325. enum {
  326.                                                                 /* Alert Flags for use in alrx resource */
  327.     kAlertFlagsUseThemeBackground = (1 << 0),
  328.     kAlertFlagsUseControlHierarchy = (1 << 1),
  329.     kAlertFlagsAlertIsMovable   = (1 << 2),
  330.     kAlertFlagsUseThemeControls = (1 << 3)
  331. };
  333. /* For dftb resource */
  334. enum {
  335.     kDialogFontNoFontStyle      = 0,
  336.     kDialogFontUseFontMask      = 0x0001,
  337.     kDialogFontUseFaceMask      = 0x0002,
  338.     kDialogFontUseSizeMask      = 0x0004,
  339.     kDialogFontUseForeColorMask = 0x0008,
  340.     kDialogFontUseBackColorMask = 0x0010,
  341.     kDialogFontUseModeMask      = 0x0020,
  342.     kDialogFontUseJustMask      = 0x0040,
  343.     kDialogFontUseAllMask       = 0x00FF,
  344.     kDialogFontAddFontSizeMask  = 0x0100,
  345.     kDialogFontUseFontNameMask  = 0x0200,
  346.     kDialogFontAddToMetaFontMask = 0x0400
  347. };
  350. struct AlertStdAlertParamRec {
  351.     Boolean                         movable;                    /* Make alert movable modal */
  352.     Boolean                         helpButton;                 /* Is there a help button? */
  353.     ModalFilterUPP                  filterProc;                 /* Event filter */
  354.     ConstStringPtr                  defaultText;                /* Text for button in OK position */
  355.     ConstStringPtr                  cancelText;                 /* Text for button in cancel position */
  356.     ConstStringPtr                  otherText;                  /* Text for button in left position */
  357.     SInt16                          defaultButton;              /* Which button behaves as the default */
  358.     SInt16                          cancelButton;               /* Which one behaves as cancel (can be 0) */
  359.     UInt16                          position;                   /* Position (kWindowDefaultPosition in this case */
  360.                                                                 /* equals kWindowAlertPositionParentWindowScreen) */
  361. };
  362. typedef struct AlertStdAlertParamRec    AlertStdAlertParamRec;
  364. typedef AlertStdAlertParamRec *         AlertStdAlertParamPtr;
  365. /* --- end Appearance 1.0 or later stuff*/
  368. /*
  369.     NOTE: Code running under MultiFinder or System 7.0 or newer
  370.     should always pass NULL to InitDialogs.
  371. */
  372. #if CALL_NOT_IN_CARBON
  373. EXTERN_API( void )
  374. InitDialogs                     (void *                 ignored)                            ONEWORDINLINE(0xA97B);
  376. EXTERN_API( void )
  377. ErrorSound                      (SoundUPP               soundProc)                          ONEWORDINLINE(0xA98C);
  379. #endif  /* CALL_NOT_IN_CARBON */
  381. EXTERN_API( DialogPtr )
  382. NewDialog                       (void *                 dStorage,
  383.                                  const Rect *           boundsRect,
  384.                                  ConstStr255Param       title,
  385.                                  Boolean                visible,
  386.                                  SInt16                 procID,
  387.                                  WindowPtr              behind,
  388.                                  Boolean                goAwayFlag,
  389.                                  SInt32                 refCon,
  390.                                  Handle                 items)                              ONEWORDINLINE(0xA97D);
  392. EXTERN_API( DialogPtr )
  393. GetNewDialog                    (SInt16                 dialogID,
  394.                                  void *                 dStorage,
  395.                                  WindowPtr              behind)                             ONEWORDINLINE(0xA97C);
  397. EXTERN_API( DialogPtr )
  398. NewColorDialog                  (void *                 dStorage,
  399.                                  const Rect *           boundsRect,
  400.                                  ConstStr255Param       title,
  401.                                  Boolean                visible,
  402.                                  SInt16                 procID,
  403.                                  WindowPtr              behind,
  404.                                  Boolean                goAwayFlag,
  405.                                  SInt32                 refCon,
  406.                                  Handle                 items)                              ONEWORDINLINE(0xAA4B);
  408. #if CALL_NOT_IN_CARBON
  409. EXTERN_API( void )
  410. CloseDialog                     (DialogPtr              theDialog)                          ONEWORDINLINE(0xA982);
  412. #endif  /* CALL_NOT_IN_CARBON */
  414. EXTERN_API( void )
  415. DisposeDialog                   (DialogPtr              theDialog)                          ONEWORDINLINE(0xA983);
  417. EXTERN_API( void )
  418. ModalDialog                     (ModalFilterUPP         modalFilter,
  419.                                  DialogItemIndex *      itemHit)                            ONEWORDINLINE(0xA991);
  421. EXTERN_API( Boolean )
  422. IsDialogEvent                   (const EventRecord *    theEvent)                           ONEWORDINLINE(0xA97F);
  424. EXTERN_API( Boolean )
  425. DialogSelect                    (const EventRecord *    theEvent,
  426.                                  DialogPtr *            theDialog,
  427.                                  DialogItemIndex *      itemHit)                            ONEWORDINLINE(0xA980);
  429. EXTERN_API( void )
  430. DrawDialog                      (DialogPtr              theDialog)                          ONEWORDINLINE(0xA981);
  432. EXTERN_API( void )
  433. UpdateDialog                    (DialogPtr              theDialog,
  434.                                  RgnHandle              updateRgn)                          ONEWORDINLINE(0xA978);
  436. EXTERN_API( void )
  437. HideDialogItem                  (DialogPtr              theDialog,
  438.                                  DialogItemIndex        itemNo)                             ONEWORDINLINE(0xA827);
  440. EXTERN_API( void )
  441. ShowDialogItem                  (DialogPtr              theDialog,
  442.                                  DialogItemIndex        itemNo)                             ONEWORDINLINE(0xA828);
  444. EXTERN_API( DialogItemIndexZeroBased )
  445. FindDialogItem                  (DialogPtr              theDialog,
  446.                                  Point                  thePt)                              ONEWORDINLINE(0xA984);
  448. EXTERN_API( void )
  449. DialogCut                       (DialogPtr              theDialog);
  451. EXTERN_API( void )
  452. DialogPaste                     (DialogPtr              theDialog);
  454. EXTERN_API( void )
  455. DialogCopy                      (DialogPtr              theDialog);
  457. EXTERN_API( void )
  458. DialogDelete                    (DialogPtr              theDialog);
  460. EXTERN_API( DialogItemIndex )
  461. Alert                           (SInt16                 alertID,
  462.                                  ModalFilterUPP         modalFilter)                        ONEWORDINLINE(0xA985);
  464. EXTERN_API( DialogItemIndex )
  465. StopAlert                       (SInt16                 alertID,
  466.                                  ModalFilterUPP         modalFilter)                        ONEWORDINLINE(0xA986);
  468. EXTERN_API( DialogItemIndex )
  469. NoteAlert                       (SInt16                 alertID,
  470.                                  ModalFilterUPP         modalFilter)                        ONEWORDINLINE(0xA987);
  472. EXTERN_API( DialogItemIndex )
  473. CautionAlert                    (SInt16                 alertID,
  474.                                  ModalFilterUPP         modalFilter)                        ONEWORDINLINE(0xA988);
  476. EXTERN_API( void )
  477. GetDialogItem                   (DialogPtr              theDialog,
  478.                                  DialogItemIndex        itemNo,
  479.                                  DialogItemType *       itemType,
  480.                                  Handle *               item,
  481.                                  Rect *                 box)                                ONEWORDINLINE(0xA98D);
  483. EXTERN_API( void )
  484. SetDialogItem                   (DialogPtr              theDialog,
  485.                                  DialogItemIndex        itemNo,
  486.                                  DialogItemType         itemType,
  487.                                  Handle                 item,
  488.                                  const Rect *           box)                                ONEWORDINLINE(0xA98E);
  490. EXTERN_API( void )
  491. ParamText                       (ConstStr255Param       param0,
  492.                                  ConstStr255Param       param1,
  493.                                  ConstStr255Param       param2,
  494.                                  ConstStr255Param       param3)                             ONEWORDINLINE(0xA98B);
  496. EXTERN_API( void )
  497. SelectDialogItemText            (DialogPtr              theDialog,
  498.                                  DialogItemIndex        itemNo,
  499.                                  SInt16                 strtSel,
  500.                                  SInt16                 endSel)                             ONEWORDINLINE(0xA97E);
  502. EXTERN_API( void )
  503. GetDialogItemText               (Handle                 item,
  504.                                  Str255                 text)                               ONEWORDINLINE(0xA990);
  506. EXTERN_API( void )
  507. SetDialogItemText               (Handle                 item,
  508.                                  ConstStr255Param       text)                               ONEWORDINLINE(0xA98F);
  510. EXTERN_API( SInt16 )
  511. GetAlertStage                   (void)                                                      TWOWORDINLINE(0x3EB8, 0x0A9A);
  513. EXTERN_API( void )
  514. SetDialogFont                   (SInt16                 fontNum)                            TWOWORDINLINE(0x31DF, 0x0AFA);
  516. EXTERN_API( void )
  517. ResetAlertStage                 (void)                                                      TWOWORDINLINE(0x4278, 0x0A9A);
  519. /* APIs in Carbon*/
  520. EXTERN_API( void )
  521. GetParamText                    (StringPtr              param0,
  522.                                  StringPtr              param1,
  523.                                  StringPtr              param2,
  524.                                  StringPtr              param3);
  527. #if CALL_NOT_IN_CARBON
  528. EXTERN_API_C( DialogPtr )
  529. newdialog                       (void *                 dStorage,
  530.                                  const Rect *           boundsRect,
  531.                                  const char *           title,
  532.                                  Boolean                visible,
  533.                                  SInt16                 procID,
  534.                                  WindowPtr              behind,
  535.                                  Boolean                goAwayFlag,
  536.                                  SInt32                 refCon,
  537.                                  Handle                 items);
  539. EXTERN_API_C( DialogPtr )
  540. newcolordialog                  (void *                 dStorage,
  541.                                  const Rect *           boundsRect,
  542.                                  const char *           title,
  543.                                  Boolean                visible,
  544.                                  SInt16                 procID,
  545.                                  WindowPtr              behind,
  546.                                  Boolean                goAwayFlag,
  547.                                  SInt32                 refCon,
  548.                                  Handle                 items);
  550. EXTERN_API_C( void )
  551. paramtext                       (const char *           param0,
  552.                                  const char *           param1,
  553.                                  const char *           param2,
  554.                                  const char *           param3);
  556. EXTERN_API_C( void )
  557. getdialogitemtext               (Handle                 item,
  558.                                  char *                 text);
  560. EXTERN_API_C( void )
  561. setdialogitemtext               (Handle                 item,
  562.                                  const char *           text);
  564. EXTERN_API_C( DialogItemIndexZeroBased )
  565. finddialogitem                  (DialogPtr              theDialog,
  566.                                  Point *                thePt);
  568. #endif  /* CALL_NOT_IN_CARBON */
  570. EXTERN_API( void )
  571. AppendDITL                      (DialogPtr              theDialog,
  572.                                  Handle                 theHandle,
  573.                                  DITLMethod             method);
  575. EXTERN_API( DialogItemIndex )
  576. CountDITL                       (DialogPtr              theDialog);
  578. EXTERN_API( void )
  579. ShortenDITL                     (DialogPtr              theDialog,
  580.                                  DialogItemIndex        numberItems);
  582. EXTERN_API( OSStatus )
  583. InsertDialogItem                (DialogPtr              theDialog,
  584.                                  DialogItemIndex        afterItem,
  585.                                  DialogItemType         itemType,
  586.                                  Handle                 itemHandle,
  587.                                  const Rect *           box);
  589. EXTERN_API( OSStatus )
  590. RemoveDialogItems               (DialogPtr              theDialog,
  591.                                  DialogItemIndex        itemNo,
  592.                                  DialogItemIndex        amountToRemove,
  593.                                  Boolean                disposeItemData);
  595. EXTERN_API( Boolean )
  596. StdFilterProc                   (DialogPtr              theDialog,
  597.                                  EventRecord *          event,
  598.                                  DialogItemIndex *      itemHit);
  600. EXTERN_API( OSErr )
  601. GetStdFilterProc                (ModalFilterUPP *       theProc)                            THREEWORDINLINE(0x303C, 0x0203, 0xAA68);
  603. EXTERN_API( OSErr )
  604. SetDialogDefaultItem            (DialogPtr              theDialog,
  605.                                  DialogItemIndex        newItem)                            THREEWORDINLINE(0x303C, 0x0304, 0xAA68);
  607. EXTERN_API( OSErr )
  608. SetDialogCancelItem             (DialogPtr              theDialog,
  609.                                  DialogItemIndex        newItem)                            THREEWORDINLINE(0x303C, 0x0305, 0xAA68);
  611. EXTERN_API( OSErr )
  612. SetDialogTracksCursor           (DialogPtr              theDialog,
  613.                                  Boolean                tracks)                             THREEWORDINLINE(0x303C, 0x0306, 0xAA68);
  617. /*
  618.   ---------------------------------------------------------------------------------------------------------
  619.     o Appearance Dialog Routines (available only with Appearance 1.0 and later)
  620.   ---------------------------------------------------------------------------------------------------------
  621. */
  623. EXTERN_API( DialogPtr )
  624. NewFeaturesDialog               (void *                 inStorage,
  625.                                  const Rect *           inBoundsRect,
  626.                                  ConstStr255Param       inTitle,
  627.                                  Boolean                inIsVisible,
  628.                                  SInt16                 inProcID,
  629.                                  WindowPtr              inBehind,
  630.                                  Boolean                inGoAwayFlag,
  631.                                  SInt32                 inRefCon,
  632.                                  Handle                 inItemListHandle,
  633.                                  UInt32                 inFlags)                            THREEWORDINLINE(0x303C, 0x110C, 0xAA68);
  635. EXTERN_API( OSErr )
  636. AutoSizeDialog                  (DialogPtr              inDialog)                           THREEWORDINLINE(0x303C, 0x020D, 0xAA68);
  638. /*
  639.     Regarding StandardAlert and constness:
  640.     Even though the inAlertParam parameter is marked const here, there was
  641.     a chance Dialog Manager would modify it on versions of Mac OS prior to 9.
  642. */
  643. EXTERN_API( OSErr )
  644. StandardAlert                   (AlertType              inAlertType,
  645.                                  ConstStr255Param       inError,
  646.                                  ConstStr255Param       inExplanation,
  647.                                  const AlertStdAlertParamRec * inAlertParam,
  648.                                  SInt16 *               outItemHit)                         THREEWORDINLINE(0x303C, 0x090E, 0xAA68);
  650. EXTERN_API( OSErr )
  651. GetDialogItemAsControl          (DialogPtr              inDialog,
  652.                                  SInt16                 inItemNo,
  653.                                  ControlHandle *        outControl)                         THREEWORDINLINE(0x303C, 0x050F, 0xAA68);
  655. EXTERN_API( OSErr )
  656. MoveDialogItem                  (DialogPtr              inDialog,
  657.                                  SInt16                 inItemNo,
  658.                                  SInt16                 inHoriz,
  659.                                  SInt16                 inVert)                             THREEWORDINLINE(0x303C, 0x0510, 0xAA68);
  661. EXTERN_API( OSErr )
  662. SizeDialogItem                  (DialogPtr              inDialog,
  663.                                  SInt16                 inItemNo,
  664.                                  SInt16                 inWidth,
  665.                                  SInt16                 inHeight)                           THREEWORDINLINE(0x303C, 0x0511, 0xAA68);
  667. EXTERN_API( OSErr )
  668. AppendDialogItemList            (DialogPtr              dialog,
  669.                                  SInt16                 ditlID,
  670.                                  DITLMethod             method)                             THREEWORDINLINE(0x303C, 0x0412, 0xAA68);
  672. /*
  673.   ---------------------------------------------------------------------------------------------------------
  674.     o Dialog Routines available only with Appearance 1.1 and later
  675.   ---------------------------------------------------------------------------------------------------------
  676. */
  678. EXTERN_API( OSStatus )
  679. SetDialogTimeout                (DialogPtr              inDialog,
  680.                                  SInt16                 inButtonToPress,
  681.                                  UInt32                 inSecondsToWait);
  683. EXTERN_API( OSStatus )
  684. GetDialogTimeout                (DialogPtr              inDialog,
  685.                                  SInt16 *               outButtonToPress,
  686.                                  UInt32 *               outSecondsToWait,
  687.                                  UInt32 *               outSecondsRemaining);
  689. EXTERN_API( OSStatus )
  690. SetModalDialogEventMask         (DialogPtr              inDialog,
  691.                                  EventMask              inMask);
  693. EXTERN_API( OSStatus )
  694. GetModalDialogEventMask         (DialogPtr              inDialog,
  695.                                  EventMask *            outMask);
  697. #if OLDROUTINENAMES
  698. #define DisposDialog(theDialog) DisposeDialog(theDialog)
  699. #define UpdtDialog(theDialog, updateRgn) UpdateDialog(theDialog, updateRgn)
  700. #define GetDItem(theDialog, itemNo, itemType, item, box) GetDialogItem(theDialog, itemNo, itemType, item, box)
  701. #define SetDItem(theDialog, itemNo, itemType, item, box) SetDialogItem(theDialog, itemNo, itemType, item, box)
  702. #define HideDItem(theDialog, itemNo) HideDialogItem(theDialog, itemNo)
  703. #define ShowDItem(theDialog, itemNo) ShowDialogItem(theDialog, itemNo)
  704. #define SelIText(theDialog, itemNo, strtSel, endSel) SelectDialogItemText(theDialog, itemNo, strtSel, endSel)
  705. #define GetIText(item, text) GetDialogItemText(item, text)
  706. #define SetIText(item, text) SetDialogItemText(item, text)
  707. #define FindDItem(theDialog, thePt) FindDialogItem(theDialog, thePt)
  708. #define NewCDialog(dStorage, boundsRect, title, visible, procID, behind, goAwayFlag, refCon, items) 
  709. NewColorDialog(dStorage, boundsRect, title, visible, procID, behind, goAwayFlag, refCon, items)
  710. #define GetAlrtStage() GetAlertStage()
  711. #define ResetAlrtStage() ResetAlertStage()
  712. #define DlgCut(theDialog) DialogCut(theDialog)
  713. #define DlgPaste(theDialog) DialogPaste(theDialog)
  714. #define DlgCopy(theDialog) DialogCopy(theDialog)
  715. #define DlgDelete(theDialog) DialogDelete(theDialog)
  716. #define SetDAFont(fontNum) SetDialogFont(fontNum)
  717. #if CGLUESUPPORTED
  718. #define newcdialog(dStorage, boundsRect, title, visible, procID, behind, goAwayFlag, refCon, items) 
  719. newcolordialog(dStorage, boundsRect, title, visible, procID, behind, goAwayFlag, refCon, items)
  720. #define getitext(item, text) getdialogitemtext(item, text)
  721. #define setitext(item, text) setdialogitemtext(item, text)
  722. #define findditem(theDialog, thePt) finddialogitem(theDialog, thePt)
  723. #endif
  725. #endif  /* OLDROUTINENAMES */
  727. /*
  728.     *****************************************************************************
  729.     *                                                                           *
  730.     * The conditional STRICT_DIALOGS has been removed from this interface file. *
  731.     * The accessor macros to a DialogRecord are no longer necessary.            *
  732.     *                                                                           *
  733.     * All *Ref Types have reverted to their original Handle and Ptr Types.      *
  734.     *                                                                           *
  735.     *****************************************************************************
  737.     Details:
  738.     The original purpose of the STRICT_ conditionals and accessor macros was to
  739.     help ease the transition to Copland.  Shared data structures are difficult
  740.     to coordinate in a preemptive multitasking OS.  By hiding the fields in a
  741.     WindowRecord and other data structures, we would begin the migration to the
  742.     discipline wherein system data structures are completely hidden from
  743.     applications.
  744.     
  745.     After many design reviews, we finally concluded that with this sort of
  746.     migration, the system could never tell when an application was no longer
  747.     peeking at a WindowRecord, and thus the data structure might never become
  748.     system owned.  Additionally, there were many other limitations in the
  749.     classic toolbox that were begging to be addressed.  The final decision was
  750.     to leave the traditional toolbox as a compatibility mode.
  751.     
  752.     We also decided to use the Handle and Ptr based types in the function
  753.     declarations.  For example, NewWindow now returns a WindowPtr rather than a
  754.     WindowRef.  The Ref types are still defined in the header files, so all
  755.     existing code will still compile exactly as it did before.  There are
  756.     several reasons why we chose to do this:
  757.     
  758.     - The importance of backwards compatibility makes it unfeasible for us to
  759.     enforce real opaque references in the implementation anytime in the
  760.     foreseeable future.  Therefore, any opaque data types (e.g. WindowRef,
  761.     ControlRef, etc.) in the documentation and header files would always be a
  762.     fake veneer of opacity.
  763.     
  764.     - There exists a significant base of books and sample code that neophyte
  765.     Macintosh developers use to learn how to program the Macintosh.  These
  766.     books and sample code all use direct data access.  Introducing opaque data
  767.     types at this point would confuse neophyte programmers more than it would
  768.     help them.
  769.     
  770.     - Direct data structure access is used by nearly all Macintosh developers. 
  771.     Changing the interfaces to reflect a false opacity would not provide any
  772.     benefit to these developers.
  773.     
  774.     - Accessor functions are useful in and of themselves as convenience
  775.     functions, without being tied to opaque data types.  We will complete and
  776.     document the Windows and Dialogs accessor functions in an upcoming release
  777.     of the interfaces.
  778. */
  779. #if !OPAQUE_TOOLBOX_STRUCTS && !ACCESSOR_CALLS_ARE_FUNCTIONS
  780. #ifdef __cplusplus
  781. inline WindowPtr    GetDialogWindow(DialogPtr dialog)       { return (WindowPtr) dialog;                        }
  782. inline SInt16       GetDialogDefaultItem(DialogPtr dialog)  { return (*(SInt16 *) (((UInt8 *) dialog) + 168));  }
  783. inline SInt16       GetDialogCancelItem(DialogPtr dialog)   { return (*(SInt16 *) (((UInt8 *) dialog) + 166));  }
  784. inline SInt16       GetDialogKeyboardFocusItem(DialogPtr dialog)    { return (SInt16) ((*(SInt16 *) (((UInt8 *) dialog) + 164)) < 0 ? -1 : (*(SInt16 *) (((UInt8 *) dialog) + 164)) + 1); }
  785. inline void     SetGrafPortOfDialog(DialogPtr dialog) { MacSetPort ((GrafPtr) dialog); }
  786. #else
  787. #define GetDialogWindow(dialog) ((WindowPtr) dialog)
  788. #define GetDialogDefaultItem(dialog) (*(SInt16 *) (((UInt8 *) dialog) + 168))
  789. #define GetDialogCancelItem(dialog) (*(SInt16 *) (((UInt8 *) dialog) + 166))
  790. #define GetDialogKeyboardFocusItem(dialog) ((SInt16)((*(SInt16 *) (((UInt8 *) dialog) + 164)) < 0 ? -1 : (*(SInt16 *) (((UInt8 *) dialog) + 164)) + 1))
  791. #define SetGrafPortOfDialog(dialog) do { MacSetPort ((GrafPtr) dialog); } while (false)
  792. #endif
  793. #endif  /* !OPAQUE_TOOLBOX_STRUCTS && !ACCESSOR_CALLS_ARE_FUNCTIONS */
  795. #if ACCESSOR_CALLS_ARE_FUNCTIONS
  796. /* Getters */
  797. EXTERN_API( WindowPtr )
  798. GetDialogWindow                 (DialogPtr              dialog);
  800. EXTERN_API( TEHandle )
  801. GetDialogTextEditHandle         (DialogPtr              dialog);
  803. EXTERN_API( SInt16 )
  804. GetDialogDefaultItem            (DialogPtr              dialog);
  806. EXTERN_API( SInt16 )
  807. GetDialogCancelItem             (DialogPtr              dialog);
  809. EXTERN_API( SInt16 )
  810. GetDialogKeyboardFocusItem      (DialogPtr              dialog);
  812. /* Setters */
  813. /* Utilities */
  814. EXTERN_API( void )
  815. SetPortDialogPort               (DialogPtr              dialog);
  817. EXTERN_API( CGrafPtr )
  818. GetDialogPort                   (DialogPtr              dialog);
  820. /* To prevent upward dependencies, GetDialogFromWindow() is defined here instead of MacWindows.i */
  821. EXTERN_API( DialogPtr )
  822. GetDialogFromWindow             (WindowPtr              window);
  824. #endif  /* ACCESSOR_CALLS_ARE_FUNCTIONS */
  826. #if CALL_NOT_IN_CARBON
  827. EXTERN_API( void )
  828. CouldDialog                     (SInt16                 dialogID)                           ONEWORDINLINE(0xA979);
  830. EXTERN_API( void )
  831. FreeDialog                      (SInt16                 dialogID)                           ONEWORDINLINE(0xA97A);
  833. EXTERN_API( void )
  834. CouldAlert                      (SInt16                 alertID)                            ONEWORDINLINE(0xA989);
  836. EXTERN_API( void )
  837. FreeAlert                       (SInt16                 alertID)                            ONEWORDINLINE(0xA98A);
  840. #endif  /* CALL_NOT_IN_CARBON */
  845. #if !TARGET_OS_MAC
  846. #endif  /* !TARGET_OS_MAC */
  853. #if PRAGMA_STRUCT_ALIGN
  854.     #pragma options align=reset
  855. #elif PRAGMA_STRUCT_PACKPUSH
  856.     #pragma pack(pop)
  857. #elif PRAGMA_STRUCT_PACK
  858.     #pragma pack()
  859. #endif
  861. #ifdef PRAGMA_IMPORT_OFF
  862. #pragma import off
  863. #elif PRAGMA_IMPORT
  864. #pragma import reset
  865. #endif
  867. #ifdef __cplusplus
  868. }
  869. #endif
  871. #endif /* __DIALOGS__ */