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

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

多媒体编程

开发平台：

Visual C++

MacWindows.h：源码内容
  1. /*
  2.      File:       MacWindows.h
  3.  
  4.      Contains:   Window Manager Interfaces
  5.  
  6.      Version:    Technology: Mac OS 9
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1997-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 __MACWINDOWS__
  18. #define __MACWINDOWS__
  20. #ifndef __MACTYPES__
  21. #include "MacTypes.h"
  22. #endif
  24. #ifndef __ALIASES__
  25. #include "Aliases.h"
  26. #endif
  28. #ifndef __APPLEEVENTS__
  29. #include "AppleEvents.h"
  30. #endif
  32. #ifndef __COLLECTIONS__
  33. #include "Collections.h"
  34. #endif
  36. #ifndef __DRAG__
  37. #include "Drag.h"
  38. #endif
  40. #ifndef __EVENTS__
  41. #include "Events.h"
  42. #endif
  44. #ifndef __MENUS__
  45. #include "Menus.h"
  46. #endif
  48. #ifndef __MIXEDMODE__
  49. #include "MixedMode.h"
  50. #endif
  52. #ifndef __QDOFFSCREEN__
  53. #include "QDOffscreen.h"
  54. #endif
  56. #ifndef __QUICKDRAW__
  57. #include "Quickdraw.h"
  58. #endif
  60. #ifndef __TEXTCOMMON__
  61. #include "TextCommon.h"
  62. #endif
  64. #ifndef __ICONS__
  65. #include "Icons.h"
  66. #endif
  68. #ifndef __MACERRORS__
  69. #include "MacErrors.h"
  70. #endif
  74. #if PRAGMA_ONCE
  75. #pragma once
  76. #endif
  78. #ifdef __cplusplus
  79. extern "C" {
  80. #endif
  82. #if PRAGMA_IMPORT
  83. #pragma import on
  84. #endif
  86. #if PRAGMA_STRUCT_ALIGN
  87.     #pragma options align=mac68k
  88. #elif PRAGMA_STRUCT_PACKPUSH
  89.     #pragma pack(push, 2)
  90. #elif PRAGMA_STRUCT_PACK
  91.     #pragma pack(2)
  92. #endif
  94. /*                                                                                                      */
  95. /* Current documentation for the Mac OS Window Manager is available on the web:                         */
  96. /*  <http://developer.apple.com/techpubs/macos8/HumanInterfaceToolbox/WindowManager/windowmanager.html> */
  97. /*                                                                                                      */
  98. /*--------------------------------------------------------------------------------------*/
  99. /* o Property Types                                                                     */
  100. /*--------------------------------------------------------------------------------------*/
  101. typedef OSType                          PropertyCreator;
  102. typedef OSType                          PropertyTag;
  103. /*--------------------------------------------------------------------------------------*/
  104. /* o Window Classes                                                                     */
  105. /*--------------------------------------------------------------------------------------*/
  107. typedef UInt32 WindowClass;
  108. enum {
  109.     kAlertWindowClass           = 1L,                           /* "I need your attention now."*/
  110.     kMovableAlertWindowClass    = 2L,                           /* "I need your attention now, but I'm kind enough to let you switch out of this app to do other things."*/
  111.     kModalWindowClass           = 3L,                           /* system modal, not draggable*/
  112.     kMovableModalWindowClass    = 4L,                           /* application modal, draggable*/
  113.     kFloatingWindowClass        = 5L,                           /* floats above all other application windows*/
  114.     kDocumentWindowClass        = 6L,                           /* document windows*/
  115.     kDesktopWindowClass         = 7L,                           /* desktop window (usually only one of these exists) - OS X only in CarbonLib 1.0*/
  116.     kUtilityWindowClass         = 8L,                           /* Available in CarbonLib 1.1 and later, and in Mac OS X*/
  117.     kHelpWindowClass            = 10L,                          /* Available in CarbonLib 1.1 and later, and in Mac OS X*/
  118.     kSheetWindowClass           = 11L,                          /* Available in CarbonLib 1.3 and later, and in Mac OS X*/
  119.     kToolbarWindowClass         = 12L,                          /* Available in CarbonLib 1.1 and later, and in Mac OS X*/
  120.     kPlainWindowClass           = 13L,                          /* Available in CarbonLib 1.2.5 and later, and Mac OS X*/
  121.     kOverlayWindowClass         = 14L,                          /* Available in Mac OS X*/
  122.     kSheetAlertWindowClass      = 15L,                          /* Available in CarbonLib 1.3 and later, and in Mac OS X 10.1 and later*/
  123.     kAltPlainWindowClass        = 16L,                          /* Available in CarbonLib 1.3 and later, and in Mac OS X 10.1 and later*/
  124.     kDrawerWindowClass          = 20L,                          /* Available in Mac OS X 10.2 or later*/
  125.     kAllWindowClasses           = (unsigned long)0xFFFFFFFF     /* for use with GetFrontWindowOfClass, FindWindowOfClass, GetNextWindowOfClass*/
  126. };
  129. /*--------------------------------------------------------------------------------------*/
  130. /* o Window Attributes                                                                  */
  131. /*--------------------------------------------------------------------------------------*/
  133. typedef UInt32                          WindowAttributes;
  134. enum {
  135.     kWindowNoAttributes         = 0L,                           /* no attributes*/
  136.     kWindowCloseBoxAttribute    = (1L << 0),                    /* window has a close box*/
  137.     kWindowHorizontalZoomAttribute = (1L << 1),                 /* window has horizontal zoom box*/
  138.     kWindowVerticalZoomAttribute = (1L << 2),                   /* window has vertical zoom box*/
  139.     kWindowFullZoomAttribute    = (kWindowVerticalZoomAttribute | kWindowHorizontalZoomAttribute),
  140.     kWindowCollapseBoxAttribute = (1L << 3),                    /* window has a collapse box*/
  141.     kWindowResizableAttribute   = (1L << 4),                    /* window is resizable*/
  142.     kWindowSideTitlebarAttribute = (1L << 5),                   /* window wants a titlebar on the side    (floating window class only)*/
  143.     kWindowNoUpdatesAttribute   = (1L << 16),                   /* this window receives no update events*/
  144.     kWindowNoActivatesAttribute = (1L << 17),                   /* this window receives no activate events*/
  145.     kWindowNoBufferingAttribute = (1L << 20),                   /* this window is not buffered (Mac OS X only)*/
  146.     kWindowStandardDocumentAttributes = (kWindowCloseBoxAttribute | kWindowFullZoomAttribute | kWindowCollapseBoxAttribute | kWindowResizableAttribute),
  147.     kWindowStandardFloatingAttributes = (kWindowCloseBoxAttribute | kWindowCollapseBoxAttribute)
  148. };
  150. /*--------------------------------------------------------------------------------------*/
  151. /* o Window Definition Type                                                             */
  152. /*--------------------------------------------------------------------------------------*/
  153. enum {
  154.     kWindowDefProcType          = FOUR_CHAR_CODE('WDEF')
  155. };
  157. /*--------------------------------------------------------------------------------------*/
  158. /* o Mac OS 7.5 Window Definition Resource IDs                                          */
  159. /*--------------------------------------------------------------------------------------*/
  160. enum {
  161.     kStandardWindowDefinition   = 0,                            /* for document windows and dialogs*/
  162.     kRoundWindowDefinition      = 1,                            /* old da-style window*/
  163.     kFloatingWindowDefinition   = 124                           /* for floating windows*/
  164. };
  166. /*--------------------------------------------------------------------------------------*/
  167. /* o Variant Codes                                                                      */
  168. /*--------------------------------------------------------------------------------------*/
  169. enum {
  170.                                                                 /* for use with kStandardWindowDefinition */
  171.     kDocumentWindowVariantCode  = 0,
  172.     kModalDialogVariantCode     = 1,
  173.     kPlainDialogVariantCode     = 2,
  174.     kShadowDialogVariantCode    = 3,
  175.     kMovableModalDialogVariantCode = 5,
  176.     kAlertVariantCode           = 7,
  177.     kMovableAlertVariantCode    = 9,                            /* for use with kFloatingWindowDefinition */
  178.     kSideFloaterVariantCode     = 8
  179. };
  182. /*--------------------------------------------------------------------------------------*/
  183. /* o DefProc IDs                                                                        */
  184. /*--------------------------------------------------------------------------------------*/
  185. enum {
  186.                                                                 /* classic ids */
  187.     documentProc                = 0,
  188.     dBoxProc                    = 1,
  189.     plainDBox                   = 2,
  190.     altDBoxProc                 = 3,
  191.     noGrowDocProc               = 4,
  192.     movableDBoxProc             = 5,
  193.     zoomDocProc                 = 8,
  194.     zoomNoGrow                  = 12,
  195.     rDocProc                    = 16,                           /* floating window defproc ids */
  196.     floatProc                   = 1985,
  197.     floatGrowProc               = 1987,
  198.     floatZoomProc               = 1989,
  199.     floatZoomGrowProc           = 1991,
  200.     floatSideProc               = 1993,
  201.     floatSideGrowProc           = 1995,
  202.     floatSideZoomProc           = 1997,
  203.     floatSideZoomGrowProc       = 1999
  204. };
  206. enum {
  207.                                                                 /* Resource IDs for theme-savvy window defprocs */
  208.     kWindowDocumentDefProcResID = 64,
  209.     kWindowDialogDefProcResID   = 65,
  210.     kWindowUtilityDefProcResID  = 66,
  211.     kWindowUtilitySideTitleDefProcResID = 67
  212. };
  214. enum {
  215.                                                                 /* Proc IDs for theme-savvy windows */
  216.     kWindowDocumentProc         = 1024,
  217.     kWindowGrowDocumentProc     = 1025,
  218.     kWindowVertZoomDocumentProc = 1026,
  219.     kWindowVertZoomGrowDocumentProc = 1027,
  220.     kWindowHorizZoomDocumentProc = 1028,
  221.     kWindowHorizZoomGrowDocumentProc = 1029,
  222.     kWindowFullZoomDocumentProc = 1030,
  223.     kWindowFullZoomGrowDocumentProc = 1031
  224. };
  227. enum {
  228.                                                                 /* Proc IDs for theme-savvy dialogs */
  229.     kWindowPlainDialogProc      = 1040,
  230.     kWindowShadowDialogProc     = 1041,
  231.     kWindowModalDialogProc      = 1042,
  232.     kWindowMovableModalDialogProc = 1043,
  233.     kWindowAlertProc            = 1044,
  234.     kWindowMovableAlertProc     = 1045
  235. };
  238. enum {
  239.                                                                 /* procIDs available from Mac OS 8.1 (Appearance 1.0.1) forward */
  240.     kWindowMovableModalGrowProc = 1046
  241. };
  244. enum {
  245.                                                                 /* Proc IDs for top title bar theme-savvy floating windows */
  246.     kWindowFloatProc            = 1057,
  247.     kWindowFloatGrowProc        = 1059,
  248.     kWindowFloatVertZoomProc    = 1061,
  249.     kWindowFloatVertZoomGrowProc = 1063,
  250.     kWindowFloatHorizZoomProc   = 1065,
  251.     kWindowFloatHorizZoomGrowProc = 1067,
  252.     kWindowFloatFullZoomProc    = 1069,
  253.     kWindowFloatFullZoomGrowProc = 1071
  254. };
  257. enum {
  258.                                                                 /* Proc IDs for side title bar theme-savvy floating windows */
  259.     kWindowFloatSideProc        = 1073,
  260.     kWindowFloatSideGrowProc    = 1075,
  261.     kWindowFloatSideVertZoomProc = 1077,
  262.     kWindowFloatSideVertZoomGrowProc = 1079,
  263.     kWindowFloatSideHorizZoomProc = 1081,
  264.     kWindowFloatSideHorizZoomGrowProc = 1083,
  265.     kWindowFloatSideFullZoomProc = 1085,
  266.     kWindowFloatSideFullZoomGrowProc = 1087
  267. };
  269. /*--------------------------------------------------------------------------------------*/
  270. /* o System 7 Window Positioning Constants                                              */
  271. /*                                                                                      */
  272. /* Passed into StandardAlert and used in 'WIND', 'DLOG', and 'ALRT' templates           */
  273. /* StandardAlert uses zero to specify the default position. Other calls use zero to     */
  274. /* specify "no position".  Do not pass these constants to RepositionWindow.  Do not     */
  275. /* store these constants in the BasicWindowDescription of a 'wind' resource.            */
  276. /*--------------------------------------------------------------------------------------*/
  278. enum {
  279.     kWindowNoPosition           = 0x0000,
  280.     kWindowDefaultPosition      = 0x0000,                       /* used by StandardAlert*/
  281.     kWindowCenterMainScreen     = 0x280A,
  282.     kWindowAlertPositionMainScreen = 0x300A,
  283.     kWindowStaggerMainScreen    = 0x380A,
  284.     kWindowCenterParentWindow   = 0xA80A,
  285.     kWindowAlertPositionParentWindow = 0xB00A,
  286.     kWindowStaggerParentWindow  = 0xB80A,
  287.     kWindowCenterParentWindowScreen = 0x680A,
  288.     kWindowAlertPositionParentWindowScreen = 0x700A,
  289.     kWindowStaggerParentWindowScreen = 0x780A
  290. };
  293. /*--------------------------------------------------------------------------------------*/
  294. /* o Window Positioning Methods                                                         */
  295. /*                                                                                      */
  296. /* Positioning methods passed to RepositionWindow.                                      */
  297. /* Do not use them in WIND, ALRT, DLOG templates.                                       */
  298. /* Do not confuse these constants with the constants above                              */
  299. /*--------------------------------------------------------------------------------------*/
  301. typedef UInt32 WindowPositionMethod;
  302. enum {
  303.     kWindowCenterOnMainScreen   = 0x00000001,
  304.     kWindowCenterOnParentWindow = 0x00000002,
  305.     kWindowCenterOnParentWindowScreen = 0x00000003,
  306.     kWindowCascadeOnMainScreen  = 0x00000004,
  307.     kWindowCascadeOnParentWindow = 0x00000005,
  308.     kWindowCascadeOnParentWindowScreen = 0x00000006,
  309.     kWindowAlertPositionOnMainScreen = 0x00000007,
  310.     kWindowAlertPositionOnParentWindow = 0x00000008,
  311.     kWindowAlertPositionOnParentWindowScreen = 0x00000009
  312. };
  315. /*--------------------------------------------------------------------------------------*/
  316. /* o GetWindowRegion Types                                                              */
  317. /*--------------------------------------------------------------------------------------*/
  318. typedef UInt16                          WindowRegionCode;
  319. enum {
  320.                                                                 /* Region values to pass into GetWindowRegion & GetWindowBounds */
  321.     kWindowTitleBarRgn          = 0,
  322.     kWindowTitleTextRgn         = 1,
  323.     kWindowCloseBoxRgn          = 2,
  324.     kWindowZoomBoxRgn           = 3,
  325.     kWindowDragRgn              = 5,
  326.     kWindowGrowRgn              = 6,
  327.     kWindowCollapseBoxRgn       = 7,
  328.     kWindowTitleProxyIconRgn    = 8,                            /* Mac OS 8.5 forward*/
  329.     kWindowStructureRgn         = 32,
  330.     kWindowContentRgn           = 33,                           /* Content area of the window; empty when the window is collapsed*/
  331.     kWindowUpdateRgn            = 34,                           /* Carbon forward*/
  332.     kWindowGlobalPortRgn        = 40                            /* Carbon forward - bounds of the window's port in global coordinates; not affected by CollapseWindow*/
  333. };
  335. /* GetWindowRegionRec - a pointer to this is passed in WDEF param for kWindowMsgGetRegion*/
  337. struct GetWindowRegionRec {
  338.     RgnHandle                       winRgn;
  339.     WindowRegionCode                regionCode;
  340. };
  341. typedef struct GetWindowRegionRec       GetWindowRegionRec;
  343. typedef GetWindowRegionRec *            GetWindowRegionPtr;
  344. typedef GetWindowRegionRec *            GetWindowRegionRecPtr;
  345. /*--------------------------------------------------------------------------------------*/
  346. /* o WDEF Message Types                                                                 */
  347. /*--------------------------------------------------------------------------------------*/
  348. /*
  349.    SetupWindowProxyDragImageRec - setup the proxy icon drag image
  350.    Both regions are allocated and disposed by the Window Manager.
  351.    The GWorld is disposed of by the Window Manager, but the WDEF must allocate
  352.    it.  See Technote on Drag Manager 1.1 additions for more information and sample code for
  353.    setting up drag images.
  354. */
  357. struct SetupWindowProxyDragImageRec {
  358.     GWorldPtr                       imageGWorld;                /* locked GWorld containing the drag image - output - can be NULL*/
  359.     RgnHandle                       imageRgn;                   /* image clip region, contains the portion of the image which gets blitted to screen - preallocated output - if imageGWorld is NULL, this is ignored*/
  360.     RgnHandle                       outlineRgn;                 /* the outline region used on shallow monitors - preallocated output - must always be non-empty*/
  361. };
  362. typedef struct SetupWindowProxyDragImageRec SetupWindowProxyDragImageRec;
  363. /* MeasureWindowTitleRec - a pointer to this is passed in WDEF param for kWindowMsgMeasureTitle*/
  365. struct MeasureWindowTitleRec {
  366.                                                                 /* output parameters (filled in by the WDEF)*/
  367.     SInt16                          fullTitleWidth;             /* text + proxy icon width*/
  368.     SInt16                          titleTextWidth;             /* text width*/
  369. };
  370. typedef struct MeasureWindowTitleRec    MeasureWindowTitleRec;
  371. typedef MeasureWindowTitleRec *         MeasureWindowTitleRecPtr;
  373. /*--------------------------------------------------------------------------------------*/
  374. /* o Standard Window Kinds                                                              */
  375. /*--------------------------------------------------------------------------------------*/
  376. enum {
  377.     dialogKind                  = 2,
  378.     userKind                    = 8,
  379.     kDialogWindowKind           = 2,
  380.     kApplicationWindowKind      = 8
  381. };
  384. /*--------------------------------------------------------------------------------------*/
  385. /* o FindWindow Result Codes                                                            */
  386. /*--------------------------------------------------------------------------------------*/
  388. typedef SInt16 WindowPartCode;
  389. enum {
  390.     inDesk                      = 0,
  391.     inNoWindow                  = 0,
  392.     inMenuBar                   = 1,
  393.     inSysWindow                 = 2,
  394.     inContent                   = 3,
  395.     inDrag                      = 4,
  396.     inGrow                      = 5,
  397.     inGoAway                    = 6,
  398.     inZoomIn                    = 7,
  399.     inZoomOut                   = 8,
  400.     inCollapseBox               = 11,                           /* Mac OS 8.0 forward*/
  401.     inProxyIcon                 = 12                            /* Mac OS 8.5 forward*/
  402. };
  405. /*--------------------------------------------------------------------------------------*/
  406. /* o Window Definition Hit Test Result Codes                                            */
  407. /*--------------------------------------------------------------------------------------*/
  409. typedef SInt16 WindowDefPartCode;
  410. enum {
  411.     wNoHit                      = 0,
  412.     wInContent                  = 1,
  413.     wInDrag                     = 2,
  414.     wInGrow                     = 3,
  415.     wInGoAway                   = 4,
  416.     wInZoomIn                   = 5,
  417.     wInZoomOut                  = 6,
  418.     wInCollapseBox              = 9,                            /* Mac OS 8.0 forward*/
  419.     wInProxyIcon                = 10                            /* Mac OS 8.5 forward*/
  420. };
  422. /*--------------------------------------------------------------------------------------*/
  423. /* o Window Definition Messages                                                         */
  424. /*--------------------------------------------------------------------------------------*/
  426. enum {
  427.     kWindowMsgDraw              = 0,
  428.     kWindowMsgHitTest           = 1,
  429.     kWindowMsgCalculateShape    = 2,
  430.     kWindowMsgInitialize        = 3,
  431.     kWindowMsgCleanUp           = 4,
  432.     kWindowMsgDrawGrowOutline   = 5,
  433.     kWindowMsgDrawGrowBox       = 6
  434. };
  436. /* Messages available from Mac OS 8.0 forward*/
  437. enum {
  438.     kWindowMsgGetFeatures       = 7,
  439.     kWindowMsgGetRegion         = 8
  440. };
  442. /* Messages available from Mac OS 8.5 forward*/
  443. enum {
  444.     kWindowMsgDragHilite        = 9,                            /* parameter boolean indicating on or off*/
  445.     kWindowMsgModified          = 10,                           /* parameter boolean indicating saved (false) or modified (true)*/
  446.     kWindowMsgDrawInCurrentPort = 11,                           /* same as kWindowMsgDraw, but must draw in current port*/
  447.     kWindowMsgSetupProxyDragImage = 12,                         /* parameter pointer to SetupWindowProxyDragImageRec*/
  448.     kWindowMsgStateChanged      = 13,                           /* something about the window's state has changed*/
  449.     kWindowMsgMeasureTitle      = 14                            /* measure and return the ideal title width*/
  450. };
  452. /* old names*/
  453. enum {
  454.     wDraw                       = 0,
  455.     wHit                        = 1,
  456.     wCalcRgns                   = 2,
  457.     wNew                        = 3,
  458.     wDispose                    = 4,
  459.     wGrow                       = 5,
  460.     wDrawGIcon                  = 6
  461. };
  463. /*--------------------------------------------------------------------------------------*/
  464. /* o State-changed Flags for kWindowMsgStateChanged                                     */
  465. /*--------------------------------------------------------------------------------------*/
  466. enum {
  467.     kWindowStateTitleChanged    = (1 << 0)
  468. };
  470. /*--------------------------------------------------------------------------------------*/
  471. /* o Window Feature Bits                                                                */
  472. /*--------------------------------------------------------------------------------------*/
  473. enum {
  474.     kWindowCanGrow              = (1 << 0),
  475.     kWindowCanZoom              = (1 << 1),
  476.     kWindowCanCollapse          = (1 << 2),
  477.     kWindowIsModal              = (1 << 3),
  478.     kWindowCanGetWindowRegion   = (1 << 4),
  479.     kWindowIsAlert              = (1 << 5),
  480.     kWindowHasTitleBar          = (1 << 6)
  481. };
  483. /* Feature bits available from Mac OS 8.5 forward*/
  484. enum {
  485.     kWindowSupportsDragHilite   = (1 << 7),                     /* window definition supports kWindowMsgDragHilite*/
  486.     kWindowSupportsModifiedBit  = (1 << 8),                     /* window definition supports kWindowMsgModified*/
  487.     kWindowCanDrawInCurrentPort = (1 << 9),                     /* window definition supports kWindowMsgDrawInCurrentPort*/
  488.     kWindowCanSetupProxyDragImage = (1 << 10),                  /* window definition supports kWindowMsgSetupProxyDragImage*/
  489.     kWindowCanMeasureTitle      = (1 << 11),                    /* window definition supports kWindowMsgMeasureTitle*/
  490.     kWindowWantsDisposeAtProcessDeath = (1 << 12),              /* window definition wants a Dispose message for windows still extant during ExitToShell*/
  491.     kWindowDefSupportsColorGrafPort = 0x40000002                /* window definition does not need the monochrome GrafPort hack during kWindowMsgCalculateShape*/
  492. };
  495. /*--------------------------------------------------------------------------------------*/
  496. /* o Desktop Pattern Resource ID                                                        */
  497. /*--------------------------------------------------------------------------------------*/
  498. enum {
  499.     deskPatID                   = 16
  500. };
  504. /*--------------------------------------------------------------------------------------*/
  505. /* o Window Color Part Codes                                                            */
  506. /*--------------------------------------------------------------------------------------*/
  507. enum {
  508.     wContentColor               = 0,
  509.     wFrameColor                 = 1,
  510.     wTextColor                  = 2,
  511.     wHiliteColor                = 3,
  512.     wTitleBarColor              = 4
  513. };
  516. /*--------------------------------------------------------------------------------------*/
  517. /*  o Region Dragging Constants                                                         */
  518. /*--------------------------------------------------------------------------------------*/
  520. enum {
  521.     kMouseUpOutOfSlop           = (long)0x80008000
  522. };
  525. /*--------------------------------------------------------------------------------------*/
  526. /* o Window Color Table                                                                 */
  527. /*--------------------------------------------------------------------------------------*/
  529. struct WinCTab {
  530.     long                            wCSeed;                     /* reserved */
  531.     short                           wCReserved;                 /* reserved */
  532.     short                           ctSize;                     /* usually 4 for windows */
  533.     ColorSpec                       ctTable[5];
  534. };
  535. typedef struct WinCTab                  WinCTab;
  537. typedef WinCTab *                       WCTabPtr;
  538. typedef WCTabPtr *                      WCTabHandle;
  539. /*--------------------------------------------------------------------------------------*/
  540. /* o WindowRecord                                                                       */
  541. /*--------------------------------------------------------------------------------------*/
  542. #if !OPAQUE_TOOLBOX_STRUCTS
  543. typedef struct WindowRecord             WindowRecord;
  544. typedef WindowRecord *                  WindowPeek;
  546. struct WindowRecord {
  547.     GrafPort                        port;
  548.     short                           windowKind;
  549.     Boolean                         visible;
  550.     Boolean                         hilited;
  551.     Boolean                         goAwayFlag;
  552.     Boolean                         spareFlag;
  553.     RgnHandle                       strucRgn;
  554.     RgnHandle                       contRgn;
  555.     RgnHandle                       updateRgn;
  556.     Handle                          windowDefProc;
  557.     Handle                          dataHandle;
  558.     StringHandle                    titleHandle;
  559.     short                           titleWidth;
  560.     Handle                          controlList;
  561.     WindowPeek                      nextWindow;
  562.     PicHandle                       windowPic;
  563.     long                            refCon;
  564. };
  566. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  568. /*--------------------------------------------------------------------------------------*/
  569. /* o Color WindowRecord                                                                 */
  570. /*--------------------------------------------------------------------------------------*/
  571. #if !OPAQUE_TOOLBOX_STRUCTS
  572. typedef struct CWindowRecord            CWindowRecord;
  573. typedef CWindowRecord *                 CWindowPeek;
  575. struct CWindowRecord {
  576.     CGrafPort                       port;
  577.     short                           windowKind;
  578.     Boolean                         visible;
  579.     Boolean                         hilited;
  580.     Boolean                         goAwayFlag;
  581.     Boolean                         spareFlag;
  582.     RgnHandle                       strucRgn;
  583.     RgnHandle                       contRgn;
  584.     RgnHandle                       updateRgn;
  585.     Handle                          windowDefProc;
  586.     Handle                          dataHandle;
  587.     StringHandle                    titleHandle;
  588.     short                           titleWidth;
  589.     Handle                          controlList;
  590.     CWindowPeek                     nextWindow;
  591.     PicHandle                       windowPic;
  592.     long                            refCon;
  593. };
  595. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  597. /*--------------------------------------------------------------------------------------*/
  598. /* o AuxWinHandle                                                                       */
  599. /*--------------------------------------------------------------------------------------*/
  600. #if !OPAQUE_TOOLBOX_STRUCTS
  601. typedef struct AuxWinRec                AuxWinRec;
  602. typedef AuxWinRec *                     AuxWinPtr;
  603. typedef AuxWinPtr *                     AuxWinHandle;
  605. struct AuxWinRec {
  606.     AuxWinHandle                    awNext;                     /*handle to next AuxWinRec*/
  607.     WindowPtr                       awOwner;                    /*ptr to window */
  608.     CTabHandle                      awCTable;                   /*color table for this window*/
  609.     Handle                          reserved;
  610.     long                            awFlags;                    /*reserved for expansion*/
  611.     CTabHandle                      awReserved;                 /*reserved for expansion*/
  612.     long                            awRefCon;                   /*user Constant*/
  613. };
  615. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  617. /*--------------------------------------------------------------------------------------*/
  618. /*  o BasicWindowDescription                                                            */
  619. /*                                                                                      */
  620. /*  Contains statically-sized basic attributes of the window, for storage in a          */
  621. /*  collection item.                                                                    */
  622. /*--------------------------------------------------------------------------------------*/
  623. /* constants for the version field*/
  624. enum {
  625.     kWindowDefinitionVersionOne = 1,
  626.     kWindowDefinitionVersionTwo = 2
  627. };
  629. /* constants for the stateflags bit field */
  630. enum {
  631.     kWindowIsCollapsedState     = (1 << 0L)
  632. };
  635. struct BasicWindowDescription {
  636.     UInt32                          descriptionSize;            /* sizeof(BasicWindowDescription)*/
  638.     Rect                            windowContentRect;          /* location on screen*/
  639.     Rect                            windowZoomRect;             /* location on screen when zoomed out*/
  640.     UInt32                          windowRefCon;               /* the refcon - __avoid saving stale pointers here__  */
  641.     UInt32                          windowStateFlags;           /* window state bit flags*/
  642.     WindowPositionMethod            windowPositionMethod;       /* method last used by RepositionWindow to position the window (if any)*/
  644.     UInt32                          windowDefinitionVersion;
  645.     union {
  646.         struct {
  647.             SInt16                          windowDefProc;      /* defProc and variant*/
  648.             Boolean                         windowHasCloseBox;
  649.         }                                 versionOne;
  651.         struct {
  652.             WindowClass                     windowClass;        /* the class*/
  653.             WindowAttributes                windowAttributes;   /* the attributes*/
  654.         }                                 versionTwo;
  656.     }                                 windowDefinition;
  657. };
  658. typedef struct BasicWindowDescription   BasicWindowDescription;
  659. /*  the window manager stores the default collection items using these IDs*/
  660. enum {
  661.     kStoredWindowSystemTag      = FOUR_CHAR_CODE('appl'),       /* Only Apple collection items will be of this tag*/
  662.     kStoredBasicWindowDescriptionID = FOUR_CHAR_CODE('sbas'),   /* BasicWindowDescription*/
  663.     kStoredWindowPascalTitleID  = FOUR_CHAR_CODE('s255')        /* pascal title string*/
  664. };
  666. /*--------------------------------------------------------------------------------------*/
  667. /* o Window Class Ordering                                                              */
  668. /*                                                                                      */
  669. /*  Special cases for the "behind" parameter in window creation calls.                  */
  670. /*--------------------------------------------------------------------------------------*/
  671. #define kFirstWindowOfClass ((WindowRef)-1L)
  672. #define kLastWindowOfClass ((WindowRef)0L)
  673. /*--------------------------------------------------------------------------------------*/
  674. /* o Zoom Information Handle                                                            */
  675. /*--------------------------------------------------------------------------------------*/
  677. struct WStateData {
  678.     Rect                            userState;                  /*user zoom state*/
  679.     Rect                            stdState;                   /*standard zoom state*/
  680. };
  681. typedef struct WStateData               WStateData;
  682. typedef WStateData *                    WStateDataPtr;
  683. typedef WStateDataPtr *                 WStateDataHandle;
  684. /*--------------------------------------------------------------------------------------*/
  685. /* o MixedMode & ProcPtrs                                                               */
  686. /*--------------------------------------------------------------------------------------*/
  687. typedef CALLBACK_API( long , WindowDefProcPtr )(short varCode, WindowRef window, short message, long param);
  688. typedef CALLBACK_API( void , DeskHookProcPtr )(Boolean mouseClick, EventRecord *theEvent);
  689. /*
  690.     WARNING: DeskHookProcPtr uses register based parameters under classic 68k
  691.              and cannot be written in a high-level language without 
  692.              the help of mixed mode or assembly glue.
  693. */
  694. typedef CALLBACK_API( OSStatus , WindowPaintProcPtr )(GDHandle device, GrafPtr qdContext, WindowRef window, RgnHandle inClientPaintRgn, RgnHandle outSystemPaintRgn, void *refCon);
  695. typedef STACK_UPP_TYPE(WindowDefProcPtr)                        WindowDefUPP;
  696. typedef REGISTER_UPP_TYPE(DeskHookProcPtr)                      DeskHookUPP;
  697. typedef STACK_UPP_TYPE(WindowPaintProcPtr)                      WindowPaintUPP;
  698. #if OPAQUE_UPP_TYPES
  699.     EXTERN_API(WindowDefUPP)
  700.     NewWindowDefUPP                (WindowDefProcPtr        userRoutine);
  702. #if CALL_NOT_IN_CARBON
  703.     EXTERN_API(DeskHookUPP)
  704.     NewDeskHookUPP                 (DeskHookProcPtr         userRoutine);
  706. #endif  /* CALL_NOT_IN_CARBON */
  708.     EXTERN_API(WindowPaintUPP)
  709.     NewWindowPaintUPP              (WindowPaintProcPtr      userRoutine);
  711.     EXTERN_API(void)
  712.     DisposeWindowDefUPP            (WindowDefUPP            userUPP);
  714. #if CALL_NOT_IN_CARBON
  715.     EXTERN_API(void)
  716.     DisposeDeskHookUPP             (DeskHookUPP             userUPP);
  718. #endif  /* CALL_NOT_IN_CARBON */
  720.     EXTERN_API(void)
  721.     DisposeWindowPaintUPP          (WindowPaintUPP          userUPP);
  723.     EXTERN_API(long)
  724.     InvokeWindowDefUPP             (short                   varCode,
  725.                                     WindowRef               window,
  726.                                     short                   message,
  727.                                     long                    param,
  728.                                     WindowDefUPP            userUPP);
  730. #if CALL_NOT_IN_CARBON
  731.     EXTERN_API(void)
  732.     InvokeDeskHookUPP              (Boolean                 mouseClick,
  733.                                     EventRecord *           theEvent,
  734.                                     DeskHookUPP             userUPP);
  736. #endif  /* CALL_NOT_IN_CARBON */
  738.     EXTERN_API(OSStatus)
  739.     InvokeWindowPaintUPP           (GDHandle                device,
  740.                                     GrafPtr                 qdContext,
  741.                                     WindowRef               window,
  742.                                     RgnHandle               inClientPaintRgn,
  743.                                     RgnHandle               outSystemPaintRgn,
  744.                                     void *                  refCon,
  745.                                     WindowPaintUPP          userUPP);
  747. #else
  748.     enum { uppWindowDefProcInfo = 0x00003BB0 };                     /* pascal 4_bytes Func(2_bytes, 4_bytes, 2_bytes, 4_bytes) */
  749.     enum { uppDeskHookProcInfo = 0x00130802 };                      /* register no_return_value Func(1_byte:D0, 4_bytes:A0) */
  750.     enum { uppWindowPaintProcInfo = 0x0003FFF0 };                   /* pascal 4_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes) */
  751.     #define NewWindowDefUPP(userRoutine)                            (WindowDefUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppWindowDefProcInfo, GetCurrentArchitecture())
  752.     #define NewDeskHookUPP(userRoutine)                             (DeskHookUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppDeskHookProcInfo, GetCurrentArchitecture())
  753.     #define NewWindowPaintUPP(userRoutine)                          (WindowPaintUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppWindowPaintProcInfo, GetCurrentArchitecture())
  754.     #define DisposeWindowDefUPP(userUPP)                            DisposeRoutineDescriptor(userUPP)
  755.     #define DisposeDeskHookUPP(userUPP)                             DisposeRoutineDescriptor(userUPP)
  756.     #define DisposeWindowPaintUPP(userUPP)                          DisposeRoutineDescriptor(userUPP)
  757.     #define InvokeWindowDefUPP(varCode, window, message, param, userUPP)  (long)CALL_FOUR_PARAMETER_UPP((userUPP), uppWindowDefProcInfo, (varCode), (window), (message), (param))
  758.     #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  759.     #pragma parameter InvokeDeskHookUPP(__D0, __A0, __A1)
  760.     void InvokeDeskHookUPP(Boolean mouseClick, EventRecord * theEvent, DeskHookUPP userUPP) = 0x4E91;
  761.     #else
  762.         #define InvokeDeskHookUPP(mouseClick, theEvent, userUPP)        CALL_TWO_PARAMETER_UPP((userUPP), uppDeskHookProcInfo, (mouseClick), (theEvent))
  763.     #endif
  764.     #define InvokeWindowPaintUPP(device, qdContext, window, inClientPaintRgn, outSystemPaintRgn, refCon, userUPP)  (OSStatus)CALL_SIX_PARAMETER_UPP((userUPP), uppWindowPaintProcInfo, (device), (qdContext), (window), (inClientPaintRgn), (outSystemPaintRgn), (refCon))
  765. #endif
  766. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  767. #define NewWindowDefProc(userRoutine)                           NewWindowDefUPP(userRoutine)
  768. #define NewDeskHookProc(userRoutine)                            NewDeskHookUPP(userRoutine)
  769. #define NewWindowPaintProc(userRoutine)                         NewWindowPaintUPP(userRoutine)
  770. #define CallWindowDefProc(userRoutine, varCode, window, message, param) InvokeWindowDefUPP(varCode, window, message, param, userRoutine)
  771. #define CallDeskHookProc(userRoutine, mouseClick, theEvent)     InvokeDeskHookUPP(mouseClick, theEvent, userRoutine)
  772. #define CallWindowPaintProc(userRoutine, device, qdContext, window, inClientPaintRgn, outSystemPaintRgn, refCon) InvokeWindowPaintUPP(device, qdContext, window, inClientPaintRgn, outSystemPaintRgn, refCon, userRoutine)
  773. /*--------------------------------------------------------------------------------------*/
  774. /* o Window Definition Spec.  Used in Carbon to specify the code that defines a window. */
  775. /*--------------------------------------------------------------------------------------*/
  776. enum {
  777.     kWindowDefProcPtr           = 0                             /* raw proc-ptr based access*/
  778. };
  781. typedef UInt32                          WindowDefType;
  783. struct WindowDefSpec {
  784.     WindowDefType                   defType;
  785.     union {
  786.         WindowDefUPP                    defProc;
  787.     }                                 u;
  788. };
  789. typedef struct WindowDefSpec            WindowDefSpec;
  790. /*--------------------------------------------------------------------------------------*/
  791. /* o Window Creation & Persistence                                                      */
  792. /*--------------------------------------------------------------------------------------*/
  793. EXTERN_API( WindowRef )
  794. GetNewCWindow                   (short                  windowID,
  795.                                  void *                 wStorage,
  796.                                  WindowRef              behind)                             ONEWORDINLINE(0xAA46);
  798. EXTERN_API( WindowRef )
  799. NewWindow                       (void *                 wStorage,
  800.                                  const Rect *           boundsRect,
  801.                                  ConstStr255Param       title,
  802.                                  Boolean                visible,
  803.                                  short                  theProc,
  804.                                  WindowRef              behind,
  805.                                  Boolean                goAwayFlag,
  806.                                  long                   refCon)                             ONEWORDINLINE(0xA913);
  808. EXTERN_API( WindowRef )
  809. GetNewWindow                    (short                  windowID,
  810.                                  void *                 wStorage,
  811.                                  WindowRef              behind)                             ONEWORDINLINE(0xA9BD);
  813. EXTERN_API( WindowRef )
  814. NewCWindow                      (void *                 wStorage,
  815.                                  const Rect *           boundsRect,
  816.                                  ConstStr255Param       title,
  817.                                  Boolean                visible,
  818.                                  short                  procID,
  819.                                  WindowRef              behind,
  820.                                  Boolean                goAwayFlag,
  821.                                  long                   refCon)                             ONEWORDINLINE(0xAA45);
  823. EXTERN_API( void )
  824. DisposeWindow                   (WindowRef              window)                             ONEWORDINLINE(0xA914);
  826. #if CALL_NOT_IN_CARBON
  827. #if TARGET_OS_MAC
  828.     #define MacCloseWindow CloseWindow
  829. #endif
  830. EXTERN_API( void )
  831. MacCloseWindow                  (WindowRef              window)                             ONEWORDINLINE(0xA92D);
  834. /*
  835.    Routines available from Mac OS 8.5 forward
  836.    or from Mac OS 8.1 forward when linking to CarbonLib
  837. */
  839. #endif  /* CALL_NOT_IN_CARBON */
  841. EXTERN_API( OSStatus )
  842. CreateNewWindow                 (WindowClass            windowClass,
  843.                                  WindowAttributes       attributes,
  844.                                  const Rect *           contentBounds,
  845.                                  WindowRef *            outWindow);
  847. /* Routines available from Mac OS 8.5 forward*/
  849. /* Create a window from a 'wind' resource*/
  850. EXTERN_API( OSStatus )
  851. CreateWindowFromResource        (SInt16                 resID,
  852.                                  WindowRef *            outWindow);
  854. /* window persistence*/
  855. EXTERN_API( OSStatus )
  856. StoreWindowIntoCollection       (WindowRef              window,
  857.                                  Collection             collection);
  859. EXTERN_API( OSStatus )
  860. CreateWindowFromCollection      (Collection             collection,
  861.                                  WindowRef *            outWindow);
  863. /* window refcounting*/
  864. EXTERN_API( OSStatus )
  865. GetWindowOwnerCount             (WindowRef              window,
  866.                                  UInt32 *               outCount);
  868. EXTERN_API( OSStatus )
  869. CloneWindow                     (WindowRef              window);
  872. /*--------------------------------------------------------------------------------------*/
  873. /* o Custom Windows                                                                     */
  874. /*--------------------------------------------------------------------------------------*/
  875. /* Routines available from Mac OS 8.1 forward when linking to CarbonLib*/
  877. EXTERN_API( OSStatus )
  878. CreateCustomWindow              (const WindowDefSpec *  def,
  879.                                  WindowClass            windowClass,
  880.                                  WindowAttributes       attributes,
  881.                                  const Rect *           contentBounds,
  882.                                  WindowRef *            outWindow);
  884. EXTERN_API( OSStatus )
  885. ReshapeCustomWindow             (WindowRef              window);
  887. /*--------------------------------------------------------------------------------------*/
  888. /* o Window Metainformation Accessors                                                   */
  889. /*--------------------------------------------------------------------------------------*/
  891. /*
  892.    Routines available from Mac OS 8.5 forward
  893.    or from Mac OS 8.1 forward when linking to CarbonLib
  894. */
  895. EXTERN_API( OSStatus )
  896. GetWindowClass                  (WindowRef              window,
  897.                                  WindowClass *          outClass);
  899. EXTERN_API( OSStatus )
  900. GetWindowAttributes             (WindowRef              window,
  901.                                  WindowAttributes *     outAttributes);
  903. /*
  904.    Routines available from Mac OS 9.0 forward
  905.    or from Mac OS 8.1 forward when linking to CarbonLib
  906. */
  907. EXTERN_API( OSStatus )
  908. ChangeWindowAttributes          (WindowRef              window,
  909.                                  WindowAttributes       setTheseAttributes,
  910.                                  WindowAttributes       clearTheseAttributes);
  912. /*--------------------------------------------------------------------------------------*/
  913. /* o Floating Windows                                                                   */
  914. /*--------------------------------------------------------------------------------------*/
  915. /*
  916.    Routines available from Mac OS 8.6 forward
  917.    or from Mac OS 8.1 forward when linking to CarbonLib
  918. */
  920. EXTERN_API( OSStatus )
  921. ShowFloatingWindows             (void);
  923. EXTERN_API( OSStatus )
  924. HideFloatingWindows             (void);
  926. EXTERN_API( Boolean )
  927. AreFloatingWindowsVisible       (void);
  931. /*--------------------------------------------------------------------------------------*/
  932. /* o Background Image                                                                   */
  933. /*--------------------------------------------------------------------------------------*/
  934. /* SetWinColor is not available in Carbon.*/
  935. #if CALL_NOT_IN_CARBON
  936. EXTERN_API( void )
  937. SetWinColor                     (WindowRef              window,
  938.                                  WCTabHandle            newColorTable)                      ONEWORDINLINE(0xAA41);
  940. /* SetDeskCPat is not available in Carbon.*/
  941. EXTERN_API( void )
  942. SetDeskCPat                     (PixPatHandle           deskPixPat)                         ONEWORDINLINE(0xAA47);
  944. /*
  945.    Routines available from Mac OS 8.5 forward
  946.    or from Mac OS 8.1 forward when linking to CarbonLib
  947. */
  948. #endif  /* CALL_NOT_IN_CARBON */
  950. EXTERN_API( OSStatus )
  951. SetWindowContentColor           (WindowRef              window,
  952.                                  const RGBColor *       color);
  954. EXTERN_API( OSStatus )
  955. GetWindowContentColor           (WindowRef              window,
  956.                                  RGBColor *             color);
  958. /* Routines available from Mac OS 8.5 forward*/
  959. EXTERN_API( OSStatus )
  960. GetWindowContentPattern         (WindowRef              window,
  961.                                  PixPatHandle           outPixPat);
  963. EXTERN_API( OSStatus )
  964. SetWindowContentPattern         (WindowRef              window,
  965.                                  PixPatHandle           pixPat);
  967. /* Routines available from Mac OS 9.0 forward*/
  969. typedef OptionBits                      WindowPaintProcOptions;
  970. enum {
  971.     kWindowPaintProcOptionsNone = 0
  972. };
  974. EXTERN_API( OSStatus )
  975. InstallWindowContentPaintProc   (WindowRef              window,
  976.                                  WindowPaintUPP         paintProc,
  977.                                  WindowPaintProcOptions  options,
  978.                                  void *                 refCon) /* can be NULL */;
  980. /*--------------------------------------------------------------------------------------*/
  981. /* o Scrolling Routines                                                                 */
  982. /*--------------------------------------------------------------------------------------*/
  984. typedef UInt32 ScrollWindowOptions;
  985. enum {
  986.     kScrollWindowNoOptions      = 0,
  987.     kScrollWindowInvalidate     = (1L << 0),                    /* add the exposed area to the window's update region*/
  988.     kScrollWindowEraseToPortBackground = (1L << 1)              /* erase the exposed area using the background color/pattern of the window's grafport*/
  989. };
  992. /* Routines available from Mac OS 8.1 forward when linking to CarbonLib*/
  994. EXTERN_API( OSStatus )
  995. ScrollWindowRect                (WindowRef              inWindow,
  996.                                  const Rect *           inScrollRect,
  997.                                  SInt16                 inHPixels,
  998.                                  SInt16                 inVPixels,
  999.                                  ScrollWindowOptions    inOptions,
  1000.                                  RgnHandle              outExposedRgn) /* can be NULL */;
  1002. EXTERN_API( OSStatus )
  1003. ScrollWindowRegion              (WindowRef              inWindow,
  1004.                                  RgnHandle              inScrollRgn,
  1005.                                  SInt16                 inHPixels,
  1006.                                  SInt16                 inVPixels,
  1007.                                  ScrollWindowOptions    inOptions,
  1008.                                  RgnHandle              outExposedRgn) /* can be NULL */;
  1012. /*--------------------------------------------------------------------------------------*/
  1013. /* o Low-Level Region & Painting Routines                                               */
  1014. /*--------------------------------------------------------------------------------------*/
  1015. EXTERN_API( void )
  1016. ClipAbove                       (WindowRef              window)                             ONEWORDINLINE(0xA90B);
  1018. /* SaveOld/DrawNew are not available in Carbon.  Use ReshapeCustomWindow instead.*/
  1019. #if CALL_NOT_IN_CARBON
  1020. EXTERN_API( void )
  1021. SaveOld                         (WindowRef              window)                             ONEWORDINLINE(0xA90E);
  1023. EXTERN_API( void )
  1024. DrawNew                         (WindowRef              window,
  1025.                                  Boolean                update)                             ONEWORDINLINE(0xA90F);
  1027. #endif  /* CALL_NOT_IN_CARBON */
  1029. EXTERN_API( void )
  1030. PaintOne                        (WindowRef              window, /* can be NULL */
  1031.                                  RgnHandle              clobberedRgn)                       ONEWORDINLINE(0xA90C);
  1033. EXTERN_API( void )
  1034. PaintBehind                     (WindowRef              startWindow, /* can be NULL */
  1035.                                  RgnHandle              clobberedRgn)                       ONEWORDINLINE(0xA90D);
  1037. EXTERN_API( void )
  1038. CalcVis                         (WindowRef              window)                             ONEWORDINLINE(0xA909);
  1040. EXTERN_API( void )
  1041. CalcVisBehind                   (WindowRef              startWindow, /* can be NULL */
  1042.                                  RgnHandle              clobberedRgn)                       ONEWORDINLINE(0xA90A);
  1044. EXTERN_API( Boolean )
  1045. CheckUpdate                     (EventRecord *          theEvent)                           ONEWORDINLINE(0xA911);
  1048. /*--------------------------------------------------------------------------------------*/
  1049. /* o Window List                                                                        */
  1050. /*--------------------------------------------------------------------------------------*/
  1051. #if TARGET_OS_MAC
  1052.     #define MacFindWindow FindWindow
  1053. #endif
  1054. EXTERN_API( WindowPartCode )
  1055. MacFindWindow                   (Point                  thePoint,
  1056.                                  WindowRef *            window)                             ONEWORDINLINE(0xA92C);
  1058. EXTERN_API( WindowRef )
  1059. FrontWindow                     (void)                                                      ONEWORDINLINE(0xA924);
  1061. EXTERN_API( void )
  1062. BringToFront                    (WindowRef              window)                             ONEWORDINLINE(0xA920);
  1064. EXTERN_API( void )
  1065. SendBehind                      (WindowRef              window,
  1066.                                  WindowRef              behindWindow)                       ONEWORDINLINE(0xA921);
  1068. EXTERN_API( void )
  1069. SelectWindow                    (WindowRef              window)                             ONEWORDINLINE(0xA91F);
  1071. /*
  1072.    Routines available from Mac OS 8.6 forward
  1073.    or from Mac OS 8.1 forward when linking to CarbonLib
  1074. */
  1076. EXTERN_API( WindowRef )
  1077. FrontNonFloatingWindow          (void);
  1079. /* Routines available from Mac OS 8.1 forward when linking to CarbonLib*/
  1081. EXTERN_API( WindowRef )
  1082. GetNextWindowOfClass            (WindowRef              inWindow,
  1083.                                  WindowClass            inWindowClass,
  1084.                                  Boolean                mustBeVisible);
  1086. EXTERN_API( WindowPtr )
  1087. GetFrontWindowOfClass           (WindowClass            inWindowClass,
  1088.                                  Boolean                mustBeVisible);
  1090. EXTERN_API( OSStatus )
  1091. FindWindowOfClass               (const Point *          where,
  1092.                                  WindowClass            inWindowClass,
  1093.                                  WindowRef *            outWindow,
  1094.                                  SInt16 *               outWindowPart);
  1097. /*--------------------------------------------------------------------------------------*/
  1098. /* o Misc Low-Level stuff                                                               */
  1099. /*--------------------------------------------------------------------------------------*/
  1100. #if CALL_NOT_IN_CARBON
  1101. EXTERN_API( void )
  1102. InitWindows                     (void)                                                      ONEWORDINLINE(0xA912);
  1104. /*  The window manager port does not exist in Carbon.   */
  1105. /*  We are investigating replacement technologies.      */
  1106. EXTERN_API( void )
  1107. GetWMgrPort                     (GrafPtr *              wPort)                              ONEWORDINLINE(0xA910);
  1109. EXTERN_API( void )
  1110. GetCWMgrPort                    (CGrafPtr *             wMgrCPort)                          ONEWORDINLINE(0xAA48);
  1112. /*
  1113.    Routines available from Mac OS 8.5 forward
  1114.    or from Mac OS 8.1 forward when linking to CarbonLib
  1115. */
  1116. #endif  /* CALL_NOT_IN_CARBON */
  1118. EXTERN_API( Boolean )
  1119. IsValidWindowPtr                (WindowPtr              possibleWindow);
  1121. /*
  1122.    Routines available from Mac OS 8.6 forward
  1123.    InitFloatingWindows is not available in Carbon;
  1124.    window ordering is always active for Carbon clients
  1125. */
  1126. #if CALL_NOT_IN_CARBON
  1127. EXTERN_API( OSStatus )
  1128. InitFloatingWindows             (void);
  1131. /*--------------------------------------------------------------------------------------*/
  1132. /* o Various & Sundry Window Accessors                                                  */
  1133. /*--------------------------------------------------------------------------------------*/
  1134. #endif  /* CALL_NOT_IN_CARBON */
  1136. EXTERN_API( void )
  1137. HiliteWindow                    (WindowRef              window,
  1138.                                  Boolean                fHilite)                            ONEWORDINLINE(0xA91C);
  1140. EXTERN_API( void )
  1141. SetWRefCon                      (WindowRef              window,
  1142.                                  long                   data)                               ONEWORDINLINE(0xA918);
  1144. EXTERN_API( long )
  1145. GetWRefCon                      (WindowRef              window)                             ONEWORDINLINE(0xA917);
  1147. EXTERN_API( void )
  1148. SetWindowPic                    (WindowRef              window,
  1149.                                  PicHandle              pic)                                ONEWORDINLINE(0xA92E);
  1151. EXTERN_API( PicHandle )
  1152. GetWindowPic                    (WindowRef              window)                             ONEWORDINLINE(0xA92F);
  1154. EXTERN_API( short )
  1155. GetWVariant                     (WindowRef              window)                             ONEWORDINLINE(0xA80A);
  1157. /* Routines available from Mac OS 8.0 (Appearance 1.0) forward*/
  1158. EXTERN_API( OSStatus )
  1159. GetWindowFeatures               (WindowRef              window,
  1160.                                  UInt32 *               outFeatures)                        THREEWORDINLINE(0x303C, 0x0013, 0xAA74);
  1162. EXTERN_API( OSStatus )
  1163. GetWindowRegion                 (WindowRef              window,
  1164.                                  WindowRegionCode       inRegionCode,
  1165.                                  RgnHandle              ioWinRgn)                           THREEWORDINLINE(0x303C, 0x0014, 0xAA74);
  1169. /*--------------------------------------------------------------------------------------*/
  1170. /* o Update Events                                                                      */
  1171. /*--------------------------------------------------------------------------------------*/
  1172. /*
  1173.    These aren't present in Carbon. Please use the InvalWindowRect, etc. routines
  1174.    below instead.
  1175. */
  1176. #if CALL_NOT_IN_CARBON
  1177. EXTERN_API( void )
  1178. InvalRect                       (const Rect *           badRect)                            ONEWORDINLINE(0xA928);
  1180. EXTERN_API( void )
  1181. InvalRgn                        (RgnHandle              badRgn)                             ONEWORDINLINE(0xA927);
  1183. EXTERN_API( void )
  1184. ValidRect                       (const Rect *           goodRect)                           ONEWORDINLINE(0xA92A);
  1186. EXTERN_API( void )
  1187. ValidRgn                        (RgnHandle              goodRgn)                            ONEWORDINLINE(0xA929);
  1189. #endif  /* CALL_NOT_IN_CARBON */
  1191. EXTERN_API( void )
  1192. BeginUpdate                     (WindowRef              window)                             ONEWORDINLINE(0xA922);
  1194. EXTERN_API( void )
  1195. EndUpdate                       (WindowRef              window)                             ONEWORDINLINE(0xA923);
  1197. /*
  1198.    Routines available from Mac OS 8.5 forward
  1199.    or from Mac OS 8.1 forward when linking to CarbonLib
  1200. */
  1202. EXTERN_API( OSStatus )
  1203. InvalWindowRgn                  (WindowRef              window,
  1204.                                  RgnHandle              region);
  1206. EXTERN_API( OSStatus )
  1207. InvalWindowRect                 (WindowRef              window,
  1208.                                  const Rect *           bounds);
  1210. EXTERN_API( OSStatus )
  1211. ValidWindowRgn                  (WindowRef              window,
  1212.                                  RgnHandle              region);
  1214. EXTERN_API( OSStatus )
  1215. ValidWindowRect                 (WindowRef              window,
  1216.                                  const Rect *           bounds);
  1219. /*--------------------------------------------------------------------------------------*/
  1220. /* o DrawGrowIcon                                                                       */
  1221. /*                                                                                      */
  1222. /*  DrawGrowIcon is deprecated from Mac OS 8.0 forward.  Theme-savvy window defprocs    */
  1223. /*  include the grow box in the window frame.                                           */
  1224. /*--------------------------------------------------------------------------------------*/
  1225. EXTERN_API( void )
  1226. DrawGrowIcon                    (WindowRef              window)                             ONEWORDINLINE(0xA904);
  1228. /*--------------------------------------------------------------------------------------*/
  1229. /* o Window Titles                                                                      */
  1230. /*--------------------------------------------------------------------------------------*/
  1231. EXTERN_API( void )
  1232. SetWTitle                       (WindowRef              window,
  1233.                                  ConstStr255Param       title)                              ONEWORDINLINE(0xA91A);
  1235. EXTERN_API( void )
  1236. GetWTitle                       (WindowRef              window,
  1237.                                  Str255                 title)                              ONEWORDINLINE(0xA919);
  1239. /*--------------------------------------------------------------------------------------*/
  1240. /* o Window Proxies                                                                     */
  1241. /*--------------------------------------------------------------------------------------*/
  1242. /*
  1243.    Routines available from Mac OS 8.5 forward
  1244.    or from Mac OS 8.1 forward when linking to CarbonLib
  1245. */
  1247. EXTERN_API( OSStatus )
  1248. SetWindowProxyFSSpec            (WindowRef              window,
  1249.                                  const FSSpec *         inFile);
  1251. EXTERN_API( OSStatus )
  1252. GetWindowProxyFSSpec            (WindowRef              window,
  1253.                                  FSSpec *               outFile);
  1255. EXTERN_API( OSStatus )
  1256. SetWindowProxyAlias             (WindowRef              window,
  1257.                                  AliasHandle            alias);
  1259. EXTERN_API( OSStatus )
  1260. GetWindowProxyAlias             (WindowRef              window,
  1261.                                  AliasHandle *          alias);
  1263. EXTERN_API( OSStatus )
  1264. SetWindowProxyCreatorAndType    (WindowRef              window,
  1265.                                  OSType                 fileCreator,
  1266.                                  OSType                 fileType,
  1267.                                  SInt16                 vRefNum);
  1269. EXTERN_API( OSStatus )
  1270. GetWindowProxyIcon              (WindowRef              window,
  1271.                                  IconRef *              outIcon);
  1273. EXTERN_API( OSStatus )
  1274. SetWindowProxyIcon              (WindowRef              window,
  1275.                                  IconRef                icon);
  1277. EXTERN_API( OSStatus )
  1278. RemoveWindowProxy               (WindowRef              window);
  1280. EXTERN_API( OSStatus )
  1281. BeginWindowProxyDrag            (WindowRef              window,
  1282.                                  DragReference *        outNewDrag,
  1283.                                  RgnHandle              outDragOutlineRgn);
  1285. EXTERN_API( OSStatus )
  1286. EndWindowProxyDrag              (WindowRef              window,
  1287.                                  DragReference          theDrag);
  1289. EXTERN_API( OSStatus )
  1290. TrackWindowProxyFromExistingDrag (WindowRef             window,
  1291.                                  Point                  startPt,
  1292.                                  DragReference          drag,
  1293.                                  RgnHandle              inDragOutlineRgn);
  1295. EXTERN_API( OSStatus )
  1296. TrackWindowProxyDrag            (WindowRef              window,
  1297.                                  Point                  startPt);
  1299. EXTERN_API( Boolean )
  1300. IsWindowModified                (WindowRef              window);
  1302. EXTERN_API( OSStatus )
  1303. SetWindowModified               (WindowRef              window,
  1304.                                  Boolean                modified);
  1306. EXTERN_API( Boolean )
  1307. IsWindowPathSelectClick         (WindowRef              window,
  1308.                                  const EventRecord *    event);
  1310. EXTERN_API( OSStatus )
  1311. WindowPathSelect                (WindowRef              window,
  1312.                                  MenuHandle             menu, /* can be NULL */
  1313.                                  SInt32 *               outMenuResult);
  1316. /*--------------------------------------------------------------------------------------*/
  1317. /*  o HiliteWindowFrameForDrag                                                          */
  1318. /*                                                                                      */
  1319. /*  If you call ShowDragHilite and HideDragHilite, you don't need to use this routine.  */
  1320. /*  If you implement custom drag hiliting, you should call HiliteWindowFrameForDrag     */
  1321. /*  when the drag is tracking inside a window with drag-hilited content.                */
  1322. /*--------------------------------------------------------------------------------------*/
  1323. /* Routines available from Mac OS 8.5 forward*/
  1325. EXTERN_API( OSStatus )
  1326. HiliteWindowFrameForDrag        (WindowRef              window,
  1327.                                  Boolean                hilited)                            TWOWORDINLINE(0x7019, 0xA829);
  1330. /*--------------------------------------------------------------------------------------*/
  1331. /* o Window Transitions                                                                 */
  1332. /*                                                                                      */
  1333. /*  TransitionWindow displays a window with accompanying animation and sound.           */
  1334. /*--------------------------------------------------------------------------------------*/
  1335. /* Routines available from Mac OS 8.5 forward*/
  1338. typedef UInt32 WindowTransitionEffect;
  1339. enum {
  1340.     kWindowZoomTransitionEffect = 1                             /* Finder-like zoom rectangles, use with Show or Open transition actions*/
  1341. };
  1344. typedef UInt32 WindowTransitionAction;
  1345. enum {
  1346.     kWindowShowTransitionAction = 1,                            /* param is rect in global coordinates from which to start the animation*/
  1347.     kWindowHideTransitionAction = 2                             /* param is rect in global coordinates at which to end the animation*/
  1348. };
  1350. EXTERN_API( OSStatus )
  1351. TransitionWindow                (WindowRef              window,
  1352.                                  WindowTransitionEffect  effect,
  1353.                                  WindowTransitionAction  action,
  1354.                                  const Rect *           rect) /* can be NULL */;
  1357. /*--------------------------------------------------------------------------------------*/
  1358. /* o Window Positioning                                                                 */
  1359. /*--------------------------------------------------------------------------------------*/
  1361. #if TARGET_OS_MAC
  1362.     #define MacMoveWindow MoveWindow
  1363. #endif
  1364. EXTERN_API( void )
  1365. MacMoveWindow                   (WindowRef              window,
  1366.                                  short                  hGlobal,
  1367.                                  short                  vGlobal,
  1368.                                  Boolean                front)                              ONEWORDINLINE(0xA91B);
  1370. EXTERN_API( void )
  1371. SizeWindow                      (WindowRef              window,
  1372.                                  short                  w,
  1373.                                  short                  h,
  1374.                                  Boolean                fUpdate)                            ONEWORDINLINE(0xA91D);
  1377. /* Note: bBox can only be NULL on Carbon or OS X systems */
  1378. EXTERN_API( long )
  1379. GrowWindow                      (WindowRef              window,
  1380.                                  Point                  startPt,
  1381.                                  const Rect *           bBox) /* can be NULL */             ONEWORDINLINE(0xA92B);
  1383. /* Note: boundsRect can only be NULL on Carbon or OS X systems */
  1384. EXTERN_API( void )
  1385. DragWindow                      (WindowRef              window,
  1386.                                  Point                  startPt,
  1387.                                  const Rect *           boundsRect) /* can be NULL */       ONEWORDINLINE(0xA925);
  1389. EXTERN_API( void )
  1390. ZoomWindow                      (WindowRef              window,
  1391.                                  WindowPartCode         partCode,
  1392.                                  Boolean                front)                              ONEWORDINLINE(0xA83A);
  1394. /* Routines available from Mac OS 8.0 (Appearance 1.0) forward*/
  1396. EXTERN_API( Boolean )
  1397. IsWindowCollapsable             (WindowRef              window)                             THREEWORDINLINE(0x303C, 0x000F, 0xAA74);
  1399. EXTERN_API( Boolean )
  1400. IsWindowCollapsed               (WindowRef              window)                             THREEWORDINLINE(0x303C, 0x0010, 0xAA74);
  1402. EXTERN_API( OSStatus )
  1403. CollapseWindow                  (WindowRef              window,
  1404.                                  Boolean                collapse)                           THREEWORDINLINE(0x303C, 0x0011, 0xAA74);
  1406. EXTERN_API( OSStatus )
  1407. CollapseAllWindows              (Boolean                collapse)                           THREEWORDINLINE(0x303C, 0x0012, 0xAA74);
  1409. /*
  1410.    Routines available from Mac OS 8.5 forward
  1411.    or from Mac OS 8.1 forward when linking to CarbonLib
  1412. */
  1414. EXTERN_API( OSStatus )
  1415. GetWindowBounds                 (WindowRef              window,
  1416.                                  WindowRegionCode       regionCode,
  1417.                                  Rect *                 globalBounds);
  1419. /* Note: newContentRect can only be NULL on Carbon or OS X systems */
  1420. EXTERN_API( Boolean )
  1421. ResizeWindow                    (WindowRef              window,
  1422.                                  Point                  startPoint,
  1423.                                  const Rect *           sizeConstraints, /* can be NULL */
  1424.                                  Rect *                 newContentRect) /* can be NULL */;
  1426. /* Routines available from Mac OS 8.5 forward*/
  1428. EXTERN_API( OSStatus )
  1429. SetWindowBounds                 (WindowRef              window,
  1430.                                  WindowRegionCode       regionCode,
  1431.                                  const Rect *           globalBounds);
  1433. EXTERN_API( OSStatus )
  1434. RepositionWindow                (WindowRef              window,
  1435.                                  WindowRef              parentWindow,
  1436.                                  WindowPositionMethod   method);
  1439. EXTERN_API( OSStatus )
  1440. MoveWindowStructure             (WindowRef              window,
  1441.                                  short                  hGlobal,
  1442.                                  short                  vGlobal);
  1444. EXTERN_API( Boolean )
  1445. IsWindowInStandardState         (WindowRef              window,
  1446.                                  Point *                idealSize,
  1447.                                  Rect *                 idealStandardState);
  1449. EXTERN_API( OSStatus )
  1450. ZoomWindowIdeal                 (WindowRef              window,
  1451.                                  SInt16                 partCode,
  1452.                                  Point *                ioIdealSize);
  1454. EXTERN_API( OSStatus )
  1455. GetWindowIdealUserState         (WindowRef              window,
  1456.                                  Rect *                 userState);
  1458. EXTERN_API( OSStatus )
  1459. SetWindowIdealUserState         (WindowRef              window,
  1460.                                  Rect *                 userState);
  1463. /*--------------------------------------------------------------------------------------*/
  1464. /* o Window Visibility                                                                  */
  1465. /*--------------------------------------------------------------------------------------*/
  1467. EXTERN_API( void )
  1468. HideWindow                      (WindowRef              window)                             ONEWORDINLINE(0xA916);
  1470. #if TARGET_OS_MAC
  1471.     #define MacShowWindow ShowWindow
  1472. #endif
  1473. EXTERN_API( void )
  1474. MacShowWindow                   (WindowRef              window)                             ONEWORDINLINE(0xA915);
  1476. EXTERN_API( void )
  1477. ShowHide                        (WindowRef              window,
  1478.                                  Boolean                showFlag)                           ONEWORDINLINE(0xA908);
  1481. /*--------------------------------------------------------------------------------------*/
  1482. /* o Window Properties                                                                  */
  1483. /*--------------------------------------------------------------------------------------*/
  1484. /*
  1485.    Routines available from Mac OS 8.5 forward
  1486.    or from Mac OS 8.1 forward when linking to CarbonLib
  1487. */
  1489. EXTERN_API( OSStatus )
  1490. GetWindowProperty               (WindowRef              window,
  1491.                                  PropertyCreator        propertyCreator,
  1492.                                  PropertyTag            propertyTag,
  1493.                                  UInt32                 bufferSize,
  1494.                                  UInt32 *               actualSize, /* can be NULL */
  1495.                                  void *                 propertyBuffer);
  1497. EXTERN_API( OSStatus )
  1498. GetWindowPropertySize           (WindowRef              window,
  1499.                                  PropertyCreator        creator,
  1500.                                  PropertyTag            tag,
  1501.                                  UInt32 *               size);
  1503. EXTERN_API( OSStatus )
  1504. SetWindowProperty               (WindowRef              window,
  1505.                                  PropertyCreator        propertyCreator,
  1506.                                  PropertyTag            propertyTag,
  1507.                                  UInt32                 propertySize,
  1508.                                  void *                 propertyBuffer);
  1510. EXTERN_API( OSStatus )
  1511. RemoveWindowProperty            (WindowRef              window,
  1512.                                  PropertyCreator        propertyCreator,
  1513.                                  PropertyTag            propertyTag);
  1516. /* Routines available from Mac OS 8.1 forward when linking to CarbonLib*/
  1518. enum {
  1519.     kWindowPropertyPersistent   = 0x00000001                    /* whether this property gets saved when flattening the window */
  1520. };
  1522. EXTERN_API( OSStatus )
  1523. GetWindowPropertyAttributes     (WindowRef              window,
  1524.                                  OSType                 propertyCreator,
  1525.                                  OSType                 propertyTag,
  1526.                                  UInt32 *               attributes);
  1528. EXTERN_API( OSStatus )
  1529. ChangeWindowPropertyAttributes  (WindowRef              window,
  1530.                                  OSType                 propertyCreator,
  1531.                                  OSType                 propertyTag,
  1532.                                  UInt32                 attributesToSet,
  1533.                                  UInt32                 attributesToClear);
  1535. /*--------------------------------------------------------------------------------------*/
  1536. /* o Utilities                                                                          */
  1537. /*--------------------------------------------------------------------------------------*/
  1538. EXTERN_API( long )
  1539. PinRect                         (const Rect *           theRect,
  1540.                                  Point                  thePt)                              ONEWORDINLINE(0xA94E);
  1543. EXTERN_API( RgnHandle )
  1544. GetGrayRgn                      (void)                                                      TWOWORDINLINE(0x2EB8, 0x09EE);
  1547. /*--------------------------------------------------------------------------------------*/
  1548. /* o Window Part Tracking                                                               */
  1549. /*--------------------------------------------------------------------------------------*/
  1550. EXTERN_API( Boolean )
  1551. TrackBox                        (WindowRef              window,
  1552.                                  Point                  thePt,
  1553.                                  WindowPartCode         partCode)                           ONEWORDINLINE(0xA83B);
  1555. EXTERN_API( Boolean )
  1556. TrackGoAway                     (WindowRef              window,
  1557.                                  Point                  thePt)                              ONEWORDINLINE(0xA91E);
  1560. /*--------------------------------------------------------------------------------------*/
  1561. /* o Region Dragging                                                                    */
  1562. /*--------------------------------------------------------------------------------------*/
  1563. EXTERN_API( long )
  1564. DragGrayRgn                     (RgnHandle              theRgn,
  1565.                                  Point                  startPt,
  1566.                                  const Rect *           limitRect,
  1567.                                  const Rect *           slopRect,
  1568.                                  short                  axis,
  1569.                                  DragGrayRgnUPP         actionProc)                         ONEWORDINLINE(0xA905);
  1571. EXTERN_API( long )
  1572. DragTheRgn                      (RgnHandle              theRgn,
  1573.                                  Point                  startPt,
  1574.                                  const Rect *           limitRect,
  1575.                                  const Rect *           slopRect,
  1576.                                  short                  axis,
  1577.                                  DragGrayRgnUPP         actionProc)                         ONEWORDINLINE(0xA926);
  1580. /*--------------------------------------------------------------------------------------*/
  1581. /*  o GetAuxWin                                                                         */
  1582. /*                                                                                      */
  1583. /*  GetAuxWin is not available in Carbon                                                */
  1584. /*--------------------------------------------------------------------------------------*/
  1585. #if !OPAQUE_TOOLBOX_STRUCTS
  1586. #if CALL_NOT_IN_CARBON
  1587. EXTERN_API( Boolean )
  1588. GetAuxWin                       (WindowRef              window,
  1589.                                  AuxWinHandle *         awHndl)                             ONEWORDINLINE(0xAA42);
  1591. #endif  /* CALL_NOT_IN_CARBON */
  1593. #endif  /* !OPAQUE_TOOLBOX_STRUCTS */
  1595. /*--------------------------------------------------------------------------------------*/
  1596. /* o C Glue                                                                             */
  1597. /*--------------------------------------------------------------------------------------*/
  1598. #if CALL_NOT_IN_CARBON
  1599. EXTERN_API_C( void )
  1600. setwtitle                       (WindowRef              window,
  1601.                                  const char *           title);
  1603. EXTERN_API_C( Boolean )
  1604. trackgoaway                     (WindowRef              window,
  1605.                                  Point *                thePt);
  1607. EXTERN_API_C( short )
  1608. findwindow                      (Point *                thePoint,
  1609.                                  WindowRef *            window);
  1611. EXTERN_API_C( void )
  1612. getwtitle                       (WindowRef              window,
  1613.                                  char *                 title);
  1615. EXTERN_API_C( long )
  1616. growwindow                      (WindowRef              window,
  1617.                                  Point *                startPt,
  1618.                                  const Rect *           bBox);
  1620. EXTERN_API_C( WindowRef )
  1621. newwindow                       (void *                 wStorage,
  1622.                                  const Rect *           boundsRect,
  1623.                                  const char *           title,
  1624.                                  Boolean                visible,
  1625.                                  short                  theProc,
  1626.                                  WindowRef              behind,
  1627.                                  Boolean                goAwayFlag,
  1628.                                  long                   refCon);
  1630. EXTERN_API_C( WindowRef )
  1631. newcwindow                      (void *                 wStorage,
  1632.                                  const Rect *           boundsRect,
  1633.                                  const char *           title,
  1634.                                  Boolean                visible,
  1635.                                  short                  procID,
  1636.                                  WindowRef              behind,
  1637.                                  Boolean                goAwayFlag,
  1638.                                  long                   refCon);
  1640. EXTERN_API_C( long )
  1641. pinrect                         (const Rect *           theRect,
  1642.                                  Point *                thePt);
  1644. EXTERN_API_C( Boolean )
  1645. trackbox                        (WindowRef              window,
  1646.                                  Point *                thePt,
  1647.                                  short                  partCode);
  1649. EXTERN_API_C( long )
  1650. draggrayrgn                     (RgnHandle              theRgn,
  1651.                                  Point *                startPt,
  1652.                                  const Rect *           boundsRect,
  1653.                                  const Rect *           slopRect,
  1654.                                  short                  axis,
  1655.                                  DragGrayRgnUPP         actionProc);
  1657. EXTERN_API_C( void )
  1658. dragwindow                      (WindowRef              window,
  1659.                                  Point *                startPt,
  1660.                                  const Rect *           boundsRect);
  1662. #endif  /* CALL_NOT_IN_CARBON */
  1664. /*--------------------------------------------------------------------------------------*/
  1665. /* o WindowRecord Accessors                                                             */
  1666. /*--------------------------------------------------------------------------------------*/
  1667. /*
  1668.     CHAPTER XVI - the Opacity Wars
  1669.     
  1670.     A long, long time ago, in a metaverse far, far away...
  1671.     
  1672.     On an ancient gravestone by the side of the road is a hastily-scrawled
  1673.     epitaph, written in an archaic dialect.  With the help of your robot guide,
  1674.     you translate it:
  1676.     "Shared data structures are difficult/impossible to coordinate in a preemptively
  1677.     multitasking OS.  To allow Apple to provide a fully reentrant toolbox in
  1678.     the future, while still maintaining a reasonable migration path for existing
  1679.     codebases and developer knowledge, the decision has been made to make all
  1680.     toolbox objects opaque."
  1681.     
  1682.     You hear a vague rumbling sound in the distance.  Your guide suggests backing
  1683.     away, but you ignore it, wishing to admire the ornamentation on the gravestone.
  1684.     
  1685.     Not the best decision.  The grave ERUPTS, a dusty maelstrom filling your
  1686.     senses, fragment of dirt and bone flying through the air.  You are thrown
  1687.     violently to the ground, shocked but conscious.
  1688.     
  1689.     The dust clears quickly, revealing a wizened man sitting on the gravestone.
  1690.     He wears a robe and speaks in deep, passionate tones:
  1691.     
  1692.     "N.B. If you attempt to access fields of the WindowRecord, ControlRecord,
  1693.     DialogRecord, or MenuInfo directly in Mac OS X, you _will_ crash.  To avoid
  1694.     this unpleasant situation, please use the accessor macros which correspond to
  1695.     the routines within the ACCESSOR_CALLS_ARE_FUNCTIONS conditional."
  1696.     
  1697.     Yes, this is another change in direction.  But you're sort 'o used to that
  1698.     by now.  And this time, there is no turning back.
  1699. */
  1700. #if !OPAQUE_TOOLBOX_STRUCTS && !ACCESSOR_CALLS_ARE_FUNCTIONS
  1701. #ifdef __cplusplus
  1702. inline CGrafPtr     GetWindowPort(WindowRef w)                  { return (CGrafPtr) w;                                                  }
  1703. inline void         SetPortWindowPort(WindowRef w)              { MacSetPort( (GrafPtr) GetWindowPort(w)); }
  1704. inline SInt16       GetWindowKind(WindowRef w)                  { return ( *(SInt16 *)  (((UInt8 *) w) + sizeof(GrafPort)));            }
  1705. inline void         SetWindowKind(WindowRef w, SInt16 wKind)    { *(SInt16 *)   (((UInt8 *) w) + sizeof(GrafPort)) = wKind;             }
  1706. #if TARGET_OS_MAC
  1707. inline Boolean      IsWindowVisible(WindowRef w)                { return *(Boolean *)   (((UInt8 *) w) + sizeof(GrafPort) + 0x2);       }
  1708. #endif
  1709. inline Boolean      MacIsWindowVisible(WindowRef w)             { return *(Boolean *)   (((UInt8 *) w) + sizeof(GrafPort) + 0x2);       }
  1710. inline Boolean      IsWindowHilited(WindowRef w)                { return *(Boolean *)   (((UInt8 *) w) + sizeof(GrafPort) + 0x3);       }
  1711. inline Boolean      GetWindowGoAwayFlag(WindowRef w)            { return *(Boolean *)   (((UInt8 *) w) + sizeof(GrafPort) + 0x4);       }
  1712. inline Boolean      GetWindowZoomFlag(WindowRef w)              { return *(Boolean *)   (((UInt8 *) w) + sizeof(GrafPort) + 0x5);       }
  1713. inline void         GetWindowStructureRgn(WindowRef w, RgnHandle r) { MacCopyRgn( *(RgnHandle *)(((UInt8 *) w) + sizeof(GrafPort) + 0x6), r );  }
  1714. inline void         GetWindowContentRgn(WindowRef w, RgnHandle r)   { MacCopyRgn( *(RgnHandle *)(((UInt8 *) w) + sizeof(GrafPort) + 0xA), r );  }
  1715. inline void         GetWindowUpdateRgn(WindowRef w, RgnHandle r)    { MacCopyRgn( *(RgnHandle *)(((UInt8 *) w) + sizeof(GrafPort) + 0xE), r );  }
  1716. inline SInt16       GetWindowTitleWidth(WindowRef w)                { return *(SInt16 *)(((UInt8 *) w) + sizeof(GrafPort) + 0x1E);          }
  1717. #if TARGET_OS_MAC
  1718. inline WindowRef    GetNextWindow(WindowRef w)                      { return *(WindowRef *) (((UInt8 *) w) + sizeof(GrafPort) + 0x24);      }
  1719. #endif
  1720. inline WindowRef    MacGetNextWindow(WindowRef w)                   { return *(WindowRef *) (((UInt8 *) w) + sizeof(GrafPort) + 0x24);      }
  1722. inline void GetWindowStandardState(WindowRef w, Rect *r)
  1723. {   Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));
  1724. if (stateRects != NULL) *r = stateRects[1];     }
  1725. inline void SetWindowStandardState(WindowRef w, const Rect *r)
  1726. {   Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));
  1727.     if (stateRects != NULL) stateRects[1] = *r;     }
  1728. inline void GetWindowUserState(WindowRef w, Rect *r)
  1729. {   Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));
  1730.     if (stateRects != NULL) *r = stateRects[0]; }
  1731. inline void SetWindowUserState(WindowRef w, const Rect *r)
  1732. { Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));
  1733.     if (stateRects != NULL) stateRects[0] = *r; }
  1734. inline Handle       GetWindowDataHandle(WindowRef w)                {   return  (((WindowPeek) (w))->dataHandle);               }
  1735. inline void         SetWindowDataHandle(WindowRef w, Handle data)   {   (((WindowPeek) (w))->dataHandle) = ((Handle) (data));   }
  1736. #else
  1737. #if TARGET_OS_MAC
  1738. #define IsWindowVisible MacIsWindowVisible
  1739. #define GetNextWindow MacGetNextWindow
  1740. #endif
  1741. #define ShowHideWindow(w)                       ShowHide(w)
  1742. #define SetPortWindowPort(w)                    MacSetPort( (GrafPtr) GetWindowPort(w) )
  1743. #define GetWindowPort(w)                        ( (CGrafPtr) w)
  1744. #define GetWindowKind(w)                        ( *(SInt16 *)   (((UInt8 *) w) + sizeof(GrafPort)))
  1745. #define SetWindowKind(w, wKind)                 ( *(SInt16 *)   (((UInt8 *) w) + sizeof(GrafPort)) = wKind )
  1746. #define MacIsWindowVisible(w)                   ( *(Boolean *)  (((UInt8 *) w) + sizeof(GrafPort) + 0x2))
  1747. #define IsWindowHilited(w)                      ( *(Boolean *)  (((UInt8 *) w) + sizeof(GrafPort) + 0x3))
  1748. #define GetWindowGoAwayFlag(w)                  ( *(Boolean *)  (((UInt8 *) w) + sizeof(GrafPort) + 0x4))
  1749. #define GetWindowZoomFlag(w)                    ( *(Boolean *)  (((UInt8 *) w) + sizeof(GrafPort) + 0x5))
  1750. #define GetWindowStructureRgn(w, aRgnHandle)    MacCopyRgn( *(RgnHandle *)(((UInt8 *) w) + sizeof(GrafPort) + 0x6), aRgnHandle )
  1751. #define GetWindowContentRgn(w, aRgnHandle)      MacCopyRgn( *(RgnHandle *)(((UInt8 *) w) + sizeof(GrafPort) + 0xA), aRgnHandle )
  1753. #define GetWindowUpdateRgn(w, aRgnHandle)       MacCopyRgn( *(RgnHandle *)(((UInt8 *) w) + sizeof(GrafPort) + 0xE), aRgnHandle )
  1755. #define GetWindowTitleWidth(w)                  ( *(SInt16 *)       (((UInt8 *) w) + sizeof(GrafPort) + 0x1E))
  1756. #define MacGetNextWindow(w)                     ( *(WindowRef *)    (((UInt8 *) w) + sizeof(GrafPort) + 0x24))
  1758. #define GetWindowStandardState(w, aRectPtr) do { Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));  
  1759.                                                                 if (stateRects != NULL) *aRectPtr = stateRects[1]; } while (false)
  1760. #define SetWindowStandardState(w, aRectPtr) do { Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));  
  1761.                                                                 if (stateRects != NULL) stateRects[1] = *aRectPtr; } while (false)
  1762. #define GetWindowUserState(w, aRectPtr)     do { Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));  
  1763.                                                                 if (stateRects != NULL) *aRectPtr = stateRects[0]; } while (false)
  1764. #define SetWindowUserState(w, aRectPtr)     do { Rect *stateRects = (  (Rect *) (**(Handle *) (((UInt8 *) w) + sizeof(GrafPort) + 0x16)));  
  1765.                                                                 if (stateRects != NULL) stateRects[0] = *aRectPtr; } while (false)
  1766. #define GetWindowDataHandle(windowRef)              (((WindowPeek) (windowRef))->dataHandle)
  1767. #define SetWindowDataHandle(windowRef, data)        (((WindowPeek) (windowRef))->dataHandle) = ((Handle) (data))
  1769. #endif  /* defined(__cplusplus) */
  1771. #endif  /* !OPAQUE_TOOLBOX_STRUCTS && !ACCESSOR_CALLS_ARE_FUNCTIONS */
  1773. #if ACCESSOR_CALLS_ARE_FUNCTIONS
  1774. /*                                                                                          */
  1775. /*  Direct modification of the close box and zoom box "flags" is not supported in Carbon.   */
  1776. /*                                                                                          */
  1777. /*  GetWindowGoAwayFlag                                                                     */
  1778. /*  GetWindowSpareFlag                                                                      */
  1779. /*  SetWindowGoAwayFlag                                                                     */
  1780. /*  SetWindowSpareFlag                                                                      */
  1781. /*                                                                                          */
  1782. /*  Use GetWindowAttributes and ChangeWindowAttributes if you must dynamically              */
  1783. /*  access the zoom box and close box attributes.                                           */
  1784. /*                                                                                          */
  1785. /* Still available as transitional API in PreCarbon.o, since GetWindowAttributes is not implemented there. */
  1786. EXTERN_API( Boolean )
  1787. GetWindowGoAwayFlag             (WindowRef              window);
  1789. EXTERN_API( Boolean )
  1790. GetWindowSpareFlag              (WindowRef              window);
  1792. /* Getters */
  1793. EXTERN_API( WindowRef )
  1794. GetWindowList                   (void);
  1796. EXTERN_API( CGrafPtr )
  1797. GetWindowPort                   (WindowRef              window);
  1799. EXTERN_API( short )
  1800. GetWindowKind                   (WindowRef              window);
  1802. #if TARGET_OS_MAC
  1803.     #define MacIsWindowVisible IsWindowVisible
  1804. #endif
  1805. EXTERN_API( Boolean )
  1806. MacIsWindowVisible              (WindowRef              window);
  1808. EXTERN_API( Boolean )
  1809. IsWindowHilited                 (WindowRef              window);
  1811. EXTERN_API( Boolean )
  1812. IsWindowUpdatePending           (WindowRef              window);
  1814. #if TARGET_OS_MAC
  1815.     #define MacGetNextWindow GetNextWindow
  1816. #endif
  1817. EXTERN_API( WindowRef )
  1818. MacGetNextWindow                (WindowRef              window);
  1820. EXTERN_API( Rect *)
  1821. GetWindowStandardState          (WindowRef              window,
  1822.                                  Rect *                 rect);
  1824. EXTERN_API( Rect *)
  1825. GetWindowUserState              (WindowRef              window,
  1826.                                  Rect *                 rect);
  1828. /* Setters */
  1829. EXTERN_API( void )
  1830. SetWindowKind                   (WindowRef              window,
  1831.                                  short                  kind);
  1833. EXTERN_API( void )
  1834. SetWindowStandardState          (WindowRef              window,
  1835.                                  const Rect *           rect);
  1837. EXTERN_API( void )
  1838. SetWindowUserState              (WindowRef              window,
  1839.                                  const Rect *           rect);
  1841. /* Utilities */
  1842. /* set the current QuickDraw port to the port associated with the window */
  1843. EXTERN_API( void )
  1844. SetPortWindowPort               (WindowRef              window);
  1846. EXTERN_API( Rect *)
  1847. GetWindowPortBounds             (WindowRef              window,
  1848.                                  Rect *                 bounds);
  1850. /* GetWindowFromPort is needed to 'cast up' to a WindowRef from a GrafPort */
  1851. EXTERN_API( WindowRef )
  1852. GetWindowFromPort               (CGrafPtr               port);
  1854. /* To prevent upward dependencies, GetDialogFromWindow() is defined in the Dialogs interface: */
  1855. /*      pascal DialogPtr        GetDialogFromWindow(WindowRef window); */
  1856. #endif  /* ACCESSOR_CALLS_ARE_FUNCTIONS */
  1866. #if PRAGMA_STRUCT_ALIGN
  1867.     #pragma options align=reset
  1868. #elif PRAGMA_STRUCT_PACKPUSH
  1869.     #pragma pack(pop)
  1870. #elif PRAGMA_STRUCT_PACK
  1871.     #pragma pack()
  1872. #endif
  1874. #ifdef PRAGMA_IMPORT_OFF
  1875. #pragma import off
  1876. #elif PRAGMA_IMPORT
  1877. #pragma import reset
  1878. #endif
  1880. #ifdef __cplusplus
  1881. }
  1882. #endif
  1884. #endif /* __MACWINDOWS__ */