/*
       File:       Appearance.h
   
       Contains:   Appearance Manager Interfaces.
   
       Version:    Technology: Mac OS 9
                   Release:    QuickTime 6.0.2
   
       Copyright:  (c) 1994-2001 by Apple Computer, Inc., all rights reserved
   
       Bugs?:      For bug reports, consult the following page on
                   the World Wide Web:
   
                       http://developer.apple.com/bugreporter/
   
  */
  ifndef __APPEARANCE__
  define __APPEARANCE__
  
  ifndef __MACTYPES__
  include <MacTypes.h>
  endif
  
  ifndef __QUICKDRAW__
  include <Quickdraw.h>
  endif
  
  ifndef __TEXTEDIT__
  include <TextEdit.h>
  endif
  
  ifndef __QDOFFSCREEN__
  include <QDOffscreen.h>
  endif
  
  ifndef __MACWINDOWS__
  include <MacWindows.h>
  endif
  
  ifndef __CONTROLS__
  include <Controls.h>
  endif
  
  ifndef __MACERRORS__
  include <MacErrors.h>
  endif
  
  /*----------------------------------------------------------------------------------*/
  /* Appearance Manager constants, etc.                                               */
  /*----------------------------------------------------------------------------------*/
  /* Appearance Manager Apple Events (1.1 and later)              */
  
  if PRAGMA_ONCE
  #pragma once
  endif
  
  ifdef __cplusplus
  extern "C" {
  endif
  
  if PRAGMA_IMPORT
  #pragma import on
  endif
  
  if PRAGMA_STRUCT_ALIGN
      #pragma options align=mac68k
  #elif PRAGMA_STRUCT_PACKPUSH
      #pragma pack(push, 2)
  #elif PRAGMA_STRUCT_PACK
      #pragma pack(2)
  endif
  
  enum {
      kAppearanceEventClass       = FOUR_CHAR_CODE('appr'),       /* Event Class */
      kAEAppearanceChanged        = FOUR_CHAR_CODE('thme'),       /* Appearance changed (e.g. platinum to hi-tech) */
      kAESystemFontChanged        = FOUR_CHAR_CODE('sysf'),       /* system font changed */
      kAESmallSystemFontChanged   = FOUR_CHAR_CODE('ssfn'),       /* small system font changed */
      kAEViewsFontChanged         = FOUR_CHAR_CODE('vfnt')        /* views font changed */
  };
  
  /*----------------------------------------------------------------------------------*/
  /* Appearance Manager file types                                                    */
  /*----------------------------------------------------------------------------------*/
  enum {
      kThemeDataFileType          = FOUR_CHAR_CODE('thme'),       /* file type for theme files */
      kThemePlatinumFileType      = FOUR_CHAR_CODE('pltn'),       /* file type for platinum appearance */
      kThemeCustomThemesFileType  = FOUR_CHAR_CODE('scen'),       /* file type for user themes */
      kThemeSoundTrackFileType    = FOUR_CHAR_CODE('tsnd')
  };
  
  enum {
      kThemeBrushDialogBackgroundActive = 1,                      /* Dialogs */
      kThemeBrushDialogBackgroundInactive = 2,                    /* Dialogs */
      kThemeBrushAlertBackgroundActive = 3,
      kThemeBrushAlertBackgroundInactive = 4,
      kThemeBrushModelessDialogBackgroundActive = 5,
      kThemeBrushModelessDialogBackgroundInactive = 6,
      kThemeBrushUtilityWindowBackgroundActive = 7,               /* Miscellaneous */
      kThemeBrushUtilityWindowBackgroundInactive = 8,             /* Miscellaneous */
      kThemeBrushListViewSortColumnBackground = 9,                /* Finder */
      kThemeBrushListViewBackground = 10,
      kThemeBrushIconLabelBackground = 11,
      kThemeBrushListViewSeparator = 12,
      kThemeBrushChasingArrows    = 13,
      kThemeBrushDragHilite       = 14,
      kThemeBrushDocumentWindowBackground = 15,
      kThemeBrushFinderWindowBackground = 16
  };
  
  /* Brushes available in Appearance 1.1 or later */
  enum {
      kThemeBrushScrollBarDelimiterActive = 17,
      kThemeBrushScrollBarDelimiterInactive = 18,
      kThemeBrushFocusHighlight   = 19,
      kThemeBrushPopupArrowActive = 20,
      kThemeBrushPopupArrowPressed = 21,
      kThemeBrushPopupArrowInactive = 22,
      kThemeBrushAppleGuideCoachmark = 23,
      kThemeBrushIconLabelBackgroundSelected = 24,
      kThemeBrushStaticAreaFill   = 25,
      kThemeBrushActiveAreaFill   = 26,
      kThemeBrushButtonFrameActive = 27,
      kThemeBrushButtonFrameInactive = 28,
      kThemeBrushButtonFaceActive = 29,
      kThemeBrushButtonFaceInactive = 30,
      kThemeBrushButtonFacePressed = 31,
      kThemeBrushButtonActiveDarkShadow = 32,
      kThemeBrushButtonActiveDarkHighlight = 33,
      kThemeBrushButtonActiveLightShadow = 34,
      kThemeBrushButtonActiveLightHighlight = 35,
      kThemeBrushButtonInactiveDarkShadow = 36,
      kThemeBrushButtonInactiveDarkHighlight = 37,
      kThemeBrushButtonInactiveLightShadow = 38,
      kThemeBrushButtonInactiveLightHighlight = 39,
      kThemeBrushButtonPressedDarkShadow = 40,
      kThemeBrushButtonPressedDarkHighlight = 41,
      kThemeBrushButtonPressedLightShadow = 42,
      kThemeBrushButtonPressedLightHighlight = 43,
      kThemeBrushBevelActiveLight = 44,
      kThemeBrushBevelActiveDark  = 45,
      kThemeBrushBevelInactiveLight = 46,
      kThemeBrushBevelInactiveDark = 47
  };
  
  /* Brushes available in Appearance 1.1.1 or later */
  enum {
      kThemeBrushNotificationWindowBackground = 48
  };
  
  /* These values are meta-brushes, specific colors that do not       */
  /* change from theme to theme. You can use them instead of using    */
  /* direct RGB values.                                               */
  enum {
      kThemeBrushBlack            = -1,
      kThemeBrushWhite            = -2
  };
  
  typedef SInt16                          ThemeBrush;
  enum {
      kThemeTextColorDialogActive = 1,
      kThemeTextColorDialogInactive = 2,
      kThemeTextColorAlertActive  = 3,
      kThemeTextColorAlertInactive = 4,
      kThemeTextColorModelessDialogActive = 5,
      kThemeTextColorModelessDialogInactive = 6,
      kThemeTextColorWindowHeaderActive = 7,
      kThemeTextColorWindowHeaderInactive = 8,
      kThemeTextColorPlacardActive = 9,
      kThemeTextColorPlacardInactive = 10,
      kThemeTextColorPlacardPressed = 11,
      kThemeTextColorPushButtonActive = 12,
      kThemeTextColorPushButtonInactive = 13,
      kThemeTextColorPushButtonPressed = 14,
      kThemeTextColorBevelButtonActive = 15,
      kThemeTextColorBevelButtonInactive = 16,
      kThemeTextColorBevelButtonPressed = 17,
      kThemeTextColorPopupButtonActive = 18,
      kThemeTextColorPopupButtonInactive = 19,
      kThemeTextColorPopupButtonPressed = 20,
      kThemeTextColorIconLabel    = 21,
      kThemeTextColorListView     = 22
  };
  
  /* Text Colors available in Appearance 1.0.1 or later */
  enum {
      kThemeTextColorDocumentWindowTitleActive = 23,
      kThemeTextColorDocumentWindowTitleInactive = 24,
      kThemeTextColorMovableModalWindowTitleActive = 25,
      kThemeTextColorMovableModalWindowTitleInactive = 26,
      kThemeTextColorUtilityWindowTitleActive = 27,
      kThemeTextColorUtilityWindowTitleInactive = 28,
      kThemeTextColorPopupWindowTitleActive = 29,
      kThemeTextColorPopupWindowTitleInactive = 30,
      kThemeTextColorRootMenuActive = 31,
      kThemeTextColorRootMenuSelected = 32,
      kThemeTextColorRootMenuDisabled = 33,
      kThemeTextColorMenuItemActive = 34,
      kThemeTextColorMenuItemSelected = 35,
      kThemeTextColorMenuItemDisabled = 36,
      kThemeTextColorPopupLabelActive = 37,
      kThemeTextColorPopupLabelInactive = 38
  };
  
  /* Text colors available in Appearance 1.1 or later */
  enum {
      kThemeTextColorTabFrontActive = 39,
      kThemeTextColorTabNonFrontActive = 40,
      kThemeTextColorTabNonFrontPressed = 41,
      kThemeTextColorTabFrontInactive = 42,
      kThemeTextColorTabNonFrontInactive = 43,
      kThemeTextColorIconLabelSelected = 44,
      kThemeTextColorBevelButtonStickyActive = 45,
      kThemeTextColorBevelButtonStickyInactive = 46
  };
  
  /* Text colors available in Appearance 1.1.1 or later */
  enum {
      kThemeTextColorNotification = 47
  };
  
  /* These values are specific colors that do not change from             */
  /* theme to theme. You can use them instead of using direct RGB values. */
  enum {
      kThemeTextColorBlack        = -1,
      kThemeTextColorWhite        = -2
  };
  
  typedef SInt16                          ThemeTextColor;
  /* States to draw primitives: disabled, active, and pressed (hilited) */
  enum {
      kThemeStateInactive         = 0,
      kThemeStateActive           = 1,
      kThemeStatePressed          = 2,
      kThemeStateRollover         = 6,
      kThemeStateDisabled         = 7
  };
  
  enum {
      kThemeStatePressedUp        = 2,                            /* draw with up pressed     (increment/decrement buttons) */
      kThemeStatePressedDown      = 3                             /* draw with down pressed (increment/decrement buttons) */
  };
  
  typedef UInt32                          ThemeDrawState;
  /*----------------------------------------------------------------------------------*/
  /* Theme cursor selectors available in Appearance 1.1 or later                      */
  /*----------------------------------------------------------------------------------*/
  enum {
      kThemeArrowCursor           = 0,
      kThemeCopyArrowCursor       = 1,
      kThemeAliasArrowCursor      = 2,
      kThemeContextualMenuArrowCursor = 3,
      kThemeIBeamCursor           = 4,
      kThemeCrossCursor           = 5,
      kThemePlusCursor            = 6,
      kThemeWatchCursor           = 7,                            /* Can Animate */
      kThemeClosedHandCursor      = 8,
      kThemeOpenHandCursor        = 9,
      kThemePointingHandCursor    = 10,
      kThemeCountingUpHandCursor  = 11,                           /* Can Animate */
      kThemeCountingDownHandCursor = 12,                          /* Can Animate */
      kThemeCountingUpAndDownHandCursor = 13,                     /* Can Animate */
      kThemeSpinningCursor        = 14,                           /* Can Animate */
      kThemeResizeLeftCursor      = 15,
      kThemeResizeRightCursor     = 16,
      kThemeResizeLeftRightCursor = 17
  };
  
  typedef UInt32                          ThemeCursor;
  /*----------------------------------------------------------------------------------*/
  /* Theme menu bar drawing states                                                    */
  /*----------------------------------------------------------------------------------*/
  enum {
      kThemeMenuBarNormal         = 0,
      kThemeMenuBarSelected       = 1
  };
  
  typedef UInt16                          ThemeMenuBarState;
  /* attributes */
  enum {
      kThemeMenuSquareMenuBar     = (1 << 0)
  };
  
  /*----------------------------------------------------------------------------------*/
  /* Theme menu drawing states                                                        */
  /*----------------------------------------------------------------------------------*/
  enum {
      kThemeMenuActive            = 0,
      kThemeMenuSelected          = 1,
      kThemeMenuDisabled          = 3
  };
  
  typedef UInt16                          ThemeMenuState;
  /*------------------------------------------------------------------------------------------*/
  /* MenuType: add kThemeMenuTypeInactive to menu type for DrawThemeMenuBackground if entire  */
  /* menu is inactive                                                                         */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeMenuTypePullDown      = 0,
      kThemeMenuTypePopUp         = 1,
      kThemeMenuTypeHierarchical  = 2,
      kThemeMenuTypeInactive      = 0x0100
  };
  
  typedef UInt16                          ThemeMenuType;
  enum {
      kThemeMenuItemPlain         = 0,
      kThemeMenuItemHierarchical  = 1,                            /* item has hierarchical arrow*/
      kThemeMenuItemScrollUpArrow = 2,                            /* for scrollable menus, indicates item is scroller*/
      kThemeMenuItemScrollDownArrow = 3,
      kThemeMenuItemAtTop         = 0x0100,                       /* indicates item is being drawn at top of menu*/
      kThemeMenuItemAtBottom      = 0x0200,                       /* indicates item is being drawn at bottom of menu*/
      kThemeMenuItemHierBackground = 0x0400,                      /* item is within a hierarchical menu*/
      kThemeMenuItemPopUpBackground = 0x0800,                     /* item is within a popped up menu*/
      kThemeMenuItemHasIcon       = 0x8000                        /* add into non-arrow type when icon present.*/
  };
  
  typedef UInt16                          ThemeMenuItemType;
  /*------------------------------------------------------------------------------------------*/
  /* Theme Backgrounds                                                                        */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeBackgroundTabPane     = 1,
      kThemeBackgroundPlacard     = 2,
      kThemeBackgroundWindowHeader = 3,
      kThemeBackgroundListViewWindowHeader = 4
  };
  
  typedef UInt32                          ThemeBackgroundKind;
  /*------------------------------------------------------------------------------------------*/
  /* Theme Collection tags for Get/SetTheme                                                   */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeNameTag               = FOUR_CHAR_CODE('name'),       /* Str255*/
      kThemeAppearanceFileNameTag = FOUR_CHAR_CODE('thme'),       /* Str255*/
      kThemeVariantNameTag        = FOUR_CHAR_CODE('varn'),       /* Str255*/
      kThemeSystemFontTag         = FOUR_CHAR_CODE('lgsf'),       /* Str255*/
      kThemeSmallSystemFontTag    = FOUR_CHAR_CODE('smsf'),       /* Str255*/
      kThemeViewsFontTag          = FOUR_CHAR_CODE('vfnt'),       /* Str255*/
      kThemeViewsFontSizeTag      = FOUR_CHAR_CODE('vfsz'),       /* SInt16*/
      kThemeDesktopPatternNameTag = FOUR_CHAR_CODE('patn'),       /* Str255*/
      kThemeDesktopPatternTag     = FOUR_CHAR_CODE('patt'),       /* <variable-length data> (flattened pattern)*/
      kThemeDesktopPictureNameTag = FOUR_CHAR_CODE('dpnm'),       /* Str255*/
      kThemeDesktopPictureAliasTag = FOUR_CHAR_CODE('dpal'),      /* <alias handle>*/
      kThemeDesktopPictureAlignmentTag = FOUR_CHAR_CODE('dpan'),  /* UInt32*/
      kThemeHighlightColorNameTag = FOUR_CHAR_CODE('hcnm'),       /* Str255*/
      kThemeHighlightColorTag     = FOUR_CHAR_CODE('hcol'),       /* RGBColor*/
      kThemeExamplePictureIDTag   = FOUR_CHAR_CODE('epic'),       /* SInt16*/
      kThemeSoundsEnabledTag      = FOUR_CHAR_CODE('snds'),       /* Boolean*/
      kThemeSoundTrackNameTag     = FOUR_CHAR_CODE('sndt'),       /* Str255*/
      kThemeSoundMaskTag          = FOUR_CHAR_CODE('smsk'),       /* UInt32*/
      kThemeUserDefinedTag        = FOUR_CHAR_CODE('user'),       /* Boolean (this should _always_ be true if present - used by Control Panel).*/
      kThemeScrollBarArrowStyleTag = FOUR_CHAR_CODE('sbar'),      /* ThemeScrollBarArrowStyle*/
      kThemeScrollBarThumbStyleTag = FOUR_CHAR_CODE('sbth'),      /* ThemeScrollBarThumbStyle*/
      kThemeSmoothFontEnabledTag  = FOUR_CHAR_CODE('smoo'),       /* Boolean*/
      kThemeSmoothFontMinSizeTag  = FOUR_CHAR_CODE('smos'),       /* UInt16 (must be >= 12 and <= 24)*/
      kThemeDblClickCollapseTag   = FOUR_CHAR_CODE('coll')        /* Boolean*/
  };
  
  /*------------------------------------------------------------------------------------------*/
  /* Theme Control Settings                                                                   */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeCheckBoxClassicX      = 0,                            /* check box with an 'X'*/
      kThemeCheckBoxCheckMark     = 1                             /* check box with a real check mark*/
  };
  
  typedef UInt16                          ThemeCheckBoxStyle;
  enum {
      kThemeScrollBarArrowsSingle = 0,                            /* single arrow on each end*/
      kThemeScrollBarArrowsLowerRight = 1                         /* double arrows only on right or bottom*/
  };
  
  typedef UInt16                          ThemeScrollBarArrowStyle;
  enum {
      kThemeScrollBarThumbNormal  = 0,                            /* normal, classic thumb size*/
      kThemeScrollBarThumbProportional = 1                        /* proportional thumbs*/
  };
  
  typedef UInt16                          ThemeScrollBarThumbStyle;
  /*------------------------------------------------------------------------------------------*/
  /* Font constants                                                                           */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeSystemFont            = 0,
      kThemeSmallSystemFont       = 1,
      kThemeSmallEmphasizedSystemFont = 2,
      kThemeViewsFont             = 3
  };
  
  typedef UInt16                          ThemeFontID;
  /*------------------------------------------------------------------------------------------*/
  /* Tab constants                                                                            */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeTabNonFront           = 0,
      kThemeTabNonFrontPressed    = 1,
      kThemeTabNonFrontInactive   = 2,
      kThemeTabFront              = 3,
      kThemeTabFrontInactive      = 4
  };
  
  typedef UInt16                          ThemeTabStyle;
  enum {
      kThemeTabNorth              = 0,
      kThemeTabSouth              = 1,
      kThemeTabEast               = 2,
      kThemeTabWest               = 3
  };
  
  typedef UInt16                          ThemeTabDirection;
  /* NOTE ON TAB HEIGHT                                                                       */
  /* Use the kThemeSmallTabHeightMax and kThemeLargeTabHeightMax when calculating the rects   */
  /* to draw tabs into. This height includes the tab frame overlap. Tabs that are not in the  */
  /* front are only drawn down to where they meet the frame, as if the height was just        */
  /* kThemeLargeTabHeight, for example, as opposed to the ...Max constant. Remember that for  */
  /* East and West tabs, the height referred to below is actually the width.                  */
  enum {
      kThemeSmallTabHeight        = 16,                           /* amount small tabs protrude from frame.*/
      kThemeLargeTabHeight        = 21,                           /* amount large tabs protrude from frame.*/
      kThemeTabPaneOverlap        = 3,                            /* amount tabs overlap frame.*/
      kThemeSmallTabHeightMax     = 19,                           /* small tab height + overlap*/
      kThemeLargeTabHeightMax     = 24                            /* large tab height + overlap*/
  };
  
  /*------------------------------------------------------------------------------------------*/
  /* Track kinds                                                                              */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeScrollBar             = 0,
      kThemeSmallScrollBar        = 1,
      kThemeSlider                = 2,
      kThemeProgressBar           = 3,
      kThemeIndeterminateBar      = 4
  };
  
  typedef UInt16                          ThemeTrackKind;
  /*------------------------------------------------------------------------------------------*/
  /* Track enable states                                                                      */
  /*------------------------------------------------------------------------------------------*/
  enum {
                                                                  /* track states */
      kThemeTrackActive           = 0,
      kThemeTrackDisabled         = 1,
      kThemeTrackNothingToScroll  = 2,
      kThemeTrackInactive         = 3
  };
  
  typedef UInt8                           ThemeTrackEnableState;
  /*------------------------------------------------------------------------------------------*/
  /* Track pressed states                                                                     */
  /*------------------------------------------------------------------------------------------*/
  enum {
                                                                  /* press states (ignored unless track is active) */
      kThemeLeftOutsideArrowPressed = 0x01,
      kThemeLeftInsideArrowPressed = 0x02,
      kThemeLeftTrackPressed      = 0x04,
      kThemeThumbPressed          = 0x08,
      kThemeRightTrackPressed     = 0x10,
      kThemeRightInsideArrowPressed = 0x20,
      kThemeRightOutsideArrowPressed = 0x40,
      kThemeTopOutsideArrowPressed = kThemeLeftOutsideArrowPressed,
      kThemeTopInsideArrowPressed = kThemeLeftInsideArrowPressed,
      kThemeTopTrackPressed       = kThemeLeftTrackPressed,
      kThemeBottomTrackPressed    = kThemeRightTrackPressed,
      kThemeBottomInsideArrowPressed = kThemeRightInsideArrowPressed,
      kThemeBottomOutsideArrowPressed = kThemeRightOutsideArrowPressed
  };
  
  typedef UInt8                           ThemeTrackPressState;
  /*------------------------------------------------------------------------------------------*/
  /* Thumb directions                                                                         */
  /*------------------------------------------------------------------------------------------*/
  enum {
                                                                  /* thumb direction */
      kThemeThumbPlain            = 0,
      kThemeThumbUpward           = 1,
      kThemeThumbDownward         = 2
  };
  
  typedef UInt8                           ThemeThumbDirection;
  /*------------------------------------------------------------------------------------------*/
  /* Track attributes                                                                         */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeTrackHorizontal       = (1 << 0),                     /* track is drawn horizontally*/
      kThemeTrackRightToLeft      = (1 << 1),                     /* track progresses from right to left*/
      kThemeTrackShowThumb        = (1 << 2),                     /* track's thumb should be drawn*/
      kThemeTrackThumbRgnIsNotGhost = (1 << 3)                    /* the provided thumbRgn should be drawn opaque, not as a ghost*/
  };
  
  typedef UInt16                          ThemeTrackAttributes;
  /*------------------------------------------------------------------------------------------*/
  /* Track info block                                                                         */
  /*------------------------------------------------------------------------------------------*/
  
  struct ScrollBarTrackInfo {
      SInt32                          viewsize;                   /* current view range size */
      ThemeTrackPressState            pressState;                 /* pressed parts state */
  };
  typedef struct ScrollBarTrackInfo       ScrollBarTrackInfo;
  
  struct SliderTrackInfo {
      ThemeThumbDirection             thumbDir;                   /* thumb direction */
      ThemeTrackPressState            pressState;                 /* pressed parts state */
  };
  typedef struct SliderTrackInfo          SliderTrackInfo;
  
  struct ProgressTrackInfo {
      UInt8                           phase;                      /* phase for indeterminate progress */
  };
  typedef struct ProgressTrackInfo        ProgressTrackInfo;
  
  struct ThemeTrackDrawInfo {
      ThemeTrackKind                  kind;                       /* what kind of track this info is for */
      Rect                            bounds;                     /* track basis rectangle */
      SInt32                          min;                        /* min track value */
      SInt32                          max;                        /* max track value */
      SInt32                          value;                      /* current thumb value */
      UInt32                          reserved;
  
      ThemeTrackAttributes            attributes;                 /* various track attributes */
      ThemeTrackEnableState           enableState;                /* enable state */
      UInt8                           filler1;
  
      union {
          ScrollBarTrackInfo              scrollbar;
          SliderTrackInfo                 slider;
          ProgressTrackInfo               progress;
      }                                 trackInfo;
  };
  typedef struct ThemeTrackDrawInfo       ThemeTrackDrawInfo;
  /*------------------------------------------------------------------------------------------*/
  /* ThemeWindowAttributes                                                                    */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeWindowHasGrow         = (1 << 0),                     /* can the size of the window be changed by the user? */
      kThemeWindowHasHorizontalZoom = (1 << 3),                   /* window can zoom only horizontally */
      kThemeWindowHasVerticalZoom = (1 << 4),                     /* window can zoom only vertically */
      kThemeWindowHasFullZoom     = kThemeWindowHasHorizontalZoom + kThemeWindowHasVerticalZoom, /* window zooms in all directions */
      kThemeWindowHasCloseBox     = (1 << 5),                     /* window has a close box */
      kThemeWindowHasCollapseBox  = (1 << 6),                     /* window has a collapse box */
      kThemeWindowHasTitleText    = (1 << 7),                     /* window has a title/title icon */
      kThemeWindowIsCollapsed     = (1 << 8),                     /* window is in the collapsed state */
      kThemeWindowHasA            = (1 << 9),
      kThemeWindowHasB            = (1 << 10)
  };
  
  typedef UInt32                          ThemeWindowAttributes;
  /*------------------------------------------------------------------------------------------*/
  /* Window Types Supported by the Appearance Manager                                         */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeDocumentWindow        = 0,
      kThemeDialogWindow          = 1,
      kThemeMovableDialogWindow   = 2,
      kThemeAlertWindow           = 3,
      kThemeMovableAlertWindow    = 4,
      kThemePlainDialogWindow     = 5,
      kThemeShadowDialogWindow    = 6,
      kThemePopupWindow           = 7,
      kThemeUtilityWindow         = 8,
      kThemeUtilitySideWindow     = 9
  };
  
  typedef UInt16                          ThemeWindowType;
  /*------------------------------------------------------------------------------------------*/
  /* Window Widgets Supported by the Appearance Manager                                       */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeWidgetCloseBox        = 0,
      kThemeWidgetZoomBox         = 1,
      kThemeWidgetCollapseBox     = 2,
      kThemeWidgetABox            = 3,
      kThemeWidgetBBox            = 4,
      kThemeWidgetBOffBox         = 5
  };
  
  typedef UInt16                          ThemeTitleBarWidget;
  /*------------------------------------------------------------------------------------------*/
  /* Popup arrow orientations                                                                 */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeArrowLeft             = 0,
      kThemeArrowDown             = 1,
      kThemeArrowRight            = 2,
      kThemeArrowUp               = 3
  };
  
  typedef UInt16                          ThemeArrowOrientation;
  /*------------------------------------------------------------------------------------------*/
  /* Popup arrow sizes                                                                        */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeArrow3pt              = 0,
      kThemeArrow5pt              = 1,
      kThemeArrow7pt              = 2,
      kThemeArrow9pt              = 3
  };
  
  typedef UInt16                          ThemePopupArrowSize;
  /*------------------------------------------------------------------------------------------*/
  /* Grow box directions                                                                      */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeGrowLeft              = (1 << 0),                     /* can grow to the left */
      kThemeGrowRight             = (1 << 1),                     /* can grow to the right */
      kThemeGrowUp                = (1 << 2),                     /* can grow up */
      kThemeGrowDown              = (1 << 3)                      /* can grow down */
  };
  
  typedef UInt16                          ThemeGrowDirection;
  /*------------------------------------------------------------------------------------------*/
  /* Button kinds                                                                             */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemePushButton            = 0,
      kThemeCheckBox              = 1,
      kThemeRadioButton           = 2,
      kThemeBevelButton           = 3,                            /* bevel button (obsolete) */
      kThemeArrowButton           = 4,                            /* popup button without text  (no label) */
      kThemePopupButton           = 5,                            /* popup button */
      kThemeDisclosureButton      = 6,
      kThemeIncDecButton          = 7,                            /* increment/decrement buttons  (no label) */
      kThemeSmallBevelButton      = 8,                            /* small-shadow bevel button */
      kThemeMediumBevelButton     = 3,                            /* med-shadow bevel button */
      kThemeLargeBevelButton      = 9                             /* large-shadow bevel button */
  };
  
  typedef UInt16                          ThemeButtonKind;
  /*------------------------------------------------------------------------------------------*/
  /* Common button values                                                                     */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeButtonOff             = 0,
      kThemeButtonOn              = 1,
      kThemeButtonMixed           = 2,
      kThemeDisclosureRight       = 0,
      kThemeDisclosureDown        = 1,
      kThemeDisclosureLeft        = 2
  };
  
  typedef UInt16                          ThemeButtonValue;
  /*------------------------------------------------------------------------------------------*/
  /* Button adornment types                                                                   */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeAdornmentNone         = 0,
      kThemeAdornmentDefault      = (1 << 0),                     /* if set, draw default ornamentation ( push button only ) */
      kThemeAdornmentFocus        = (1 << 2),                     /* if set, draw focus */
      kThemeAdornmentRightToLeft  = (1 << 4),                     /* if set, draw right to left label */
      kThemeAdornmentDrawIndicatorOnly = (1 << 5)                 /* if set, don't draw or erase label ( radio, check, disclosure ) */
  };
  
  typedef UInt16                          ThemeButtonAdornment;
  /*------------------------------------------------------------------------------------------*/
  /* Button drawing info block                                                                */
  /*------------------------------------------------------------------------------------------*/
  
  struct ThemeButtonDrawInfo {
      ThemeDrawState                  state;
      ThemeButtonValue                value;
      ThemeButtonAdornment            adornment;
  };
  typedef struct ThemeButtonDrawInfo      ThemeButtonDrawInfo;
  typedef ThemeButtonDrawInfo *           ThemeButtonDrawInfoPtr;
  /*------------------------------------------------------------------------------------------*/
  /* Sound Support                                                                            */
  /*------------------------------------------------------------------------------------------*/
  /*------------------------------------------------------------------------------------------*/
  /* Sound classes                                                                            */
  /*                                                                                          */
  /* You can use the constants below to set what sounds are active using the SetTheme API.    */
  /* Use these with the kThemeSoundMask tag.                                                  */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeNoSounds              = 0,
      kThemeWindowSoundsMask      = (1 << 0),
      kThemeMenuSoundsMask        = (1 << 1),
      kThemeControlSoundsMask     = (1 << 2),
      kThemeFinderSoundsMask      = (1 << 3)
  };
  
  /*------------------------------------------------------------------------------------------*/
  /* Drag Sounds                                                                              */
  /*                                                                                          */
  /* Drag sounds are looped for the duration of the drag.                                     */
  /*                                                                                          */
  /* Call BeginThemeDragSound at the start of the drag.                                       */
  /* Call EndThemeDragSound when the drag has finished.                                       */
  /*                                                                                          */
  /* Note that in order to maintain a consistent user experience, only one drag sound may     */
  /* occur at a time.  The sound should be attached to a mouse action, start after the        */
  /* mouse goes down and stop when the mouse is released.                                     */
  /*------------------------------------------------------------------------------------------*/
  enum {
      kThemeDragSoundNone         = 0,
      kThemeDragSoundMoveWindow   = FOUR_CHAR_CODE('wmov'),
      kThemeDragSoundGrowWindow   = FOUR_CHAR_CODE('wgro'),
      kThemeDragSoundMoveUtilWindow = FOUR_CHAR_CODE('umov'),
      kThemeDragSoundGrowUtilWindow = FOUR_CHAR_CODE('ugro'),
      kThemeDragSoundMoveDialog   = FOUR_CHAR_CODE('dmov'),
      kThemeDragSoundMoveAlert    = FOUR_CHAR_CODE('amov'),
      kThemeDragSoundMoveIcon     = FOUR_CHAR_CODE('imov'),
      kThemeDragSoundSliderThumb  = FOUR_CHAR_CODE('slth'),
      kThemeDragSoundSliderGhost  = FOUR_CHAR_CODE('slgh'),
      kThemeDragSoundScrollBarThumb = FOUR_CHAR_CODE('sbth'),
      kThemeDragSoundScrollBarGhost = FOUR_CHAR_CODE('sbgh'),
      kThemeDragSoundScrollBarArrowDecreasing = FOUR_CHAR_CODE('sbad'),
      kThemeDragSoundScrollBarArrowIncreasing = FOUR_CHAR_CODE('sbai'),
      kThemeDragSoundDragging     = FOUR_CHAR_CODE('drag')
  };
  
  typedef OSType                          ThemeDragSoundKind;
  /*--------------------------------------------------------------------------*/
  /* State-change sounds                                                      */
  /*                                                                          */
  /* State-change sounds are played asynchonously as a one-shot.              */
  /*                                                                          */
  /* Call PlayThemeSound to play the sound.  The sound will play              */
  /* asynchronously until complete, then stop automatically.                  */
  /*--------------------------------------------------------------------------*/
  enum {
      kThemeSoundNone             = 0,
      kThemeSoundMenuOpen         = FOUR_CHAR_CODE('mnuo'),       /* menu sounds */
      kThemeSoundMenuClose        = FOUR_CHAR_CODE('mnuc'),
      kThemeSoundMenuItemHilite   = FOUR_CHAR_CODE('mnui'),
      kThemeSoundMenuItemRelease  = FOUR_CHAR_CODE('mnus'),
      kThemeSoundWindowClosePress = FOUR_CHAR_CODE('wclp'),       /* window sounds */
      kThemeSoundWindowCloseEnter = FOUR_CHAR_CODE('wcle'),
      kThemeSoundWindowCloseExit  = FOUR_CHAR_CODE('wclx'),
      kThemeSoundWindowCloseRelease = FOUR_CHAR_CODE('wclr'),
      kThemeSoundWindowZoomPress  = FOUR_CHAR_CODE('wzmp'),
      kThemeSoundWindowZoomEnter  = FOUR_CHAR_CODE('wzme'),
      kThemeSoundWindowZoomExit   = FOUR_CHAR_CODE('wzmx'),
      kThemeSoundWindowZoomRelease = FOUR_CHAR_CODE('wzmr'),
      kThemeSoundWindowCollapsePress = FOUR_CHAR_CODE('wcop'),
      kThemeSoundWindowCollapseEnter = FOUR_CHAR_CODE('wcoe'),
      kThemeSoundWindowCollapseExit = FOUR_CHAR_CODE('wcox'),
      kThemeSoundWindowCollapseRelease = FOUR_CHAR_CODE('wcor'),
      kThemeSoundWindowDragBoundary = FOUR_CHAR_CODE('wdbd'),
      kThemeSoundUtilWinClosePress = FOUR_CHAR_CODE('uclp'),      /* utility window sounds */
      kThemeSoundUtilWinCloseEnter = FOUR_CHAR_CODE('ucle'),
      kThemeSoundUtilWinCloseExit = FOUR_CHAR_CODE('uclx'),
      kThemeSoundUtilWinCloseRelease = FOUR_CHAR_CODE('uclr'),
      kThemeSoundUtilWinZoomPress = FOUR_CHAR_CODE('uzmp'),
      kThemeSoundUtilWinZoomEnter = FOUR_CHAR_CODE('uzme'),
      kThemeSoundUtilWinZoomExit  = FOUR_CHAR_CODE('uzmx'),
      kThemeSoundUtilWinZoomRelease = FOUR_CHAR_CODE('uzmr'),
      kThemeSoundUtilWinCollapsePress = FOUR_CHAR_CODE('ucop'),
      kThemeSoundUtilWinCollapseEnter = FOUR_CHAR_CODE('ucoe'),
      kThemeSoundUtilWinCollapseExit = FOUR_CHAR_CODE('ucox'),
      kThemeSoundUtilWinCollapseRelease = FOUR_CHAR_CODE('ucor'),
      kThemeSoundUtilWinDragBoundary = FOUR_CHAR_CODE('udbd'),
      kThemeSoundWindowOpen       = FOUR_CHAR_CODE('wopn'),       /* window close and zoom action */
      kThemeSoundWindowClose      = FOUR_CHAR_CODE('wcls'),
      kThemeSoundWindowZoomIn     = FOUR_CHAR_CODE('wzmi'),
      kThemeSoundWindowZoomOut    = FOUR_CHAR_CODE('wzmo'),
      kThemeSoundWindowCollapseUp = FOUR_CHAR_CODE('wcol'),
      kThemeSoundWindowCollapseDown = FOUR_CHAR_CODE('wexp'),
      kThemeSoundWindowActivate   = FOUR_CHAR_CODE('wact'),
      kThemeSoundUtilWindowOpen   = FOUR_CHAR_CODE('uopn'),
      kThemeSoundUtilWindowClose  = FOUR_CHAR_CODE('ucls'),
      kThemeSoundUtilWindowZoomIn = FOUR_CHAR_CODE('uzmi'),
      kThemeSoundUtilWindowZoomOut = FOUR_CHAR_CODE('uzmo'),
      kThemeSoundUtilWindowCollapseUp = FOUR_CHAR_CODE('ucol'),
      kThemeSoundUtilWindowCollapseDown = FOUR_CHAR_CODE('uexp'),
      kThemeSoundUtilWindowActivate = FOUR_CHAR_CODE('uact'),
      kThemeSoundDialogOpen       = FOUR_CHAR_CODE('dopn'),
      kThemeSoundDialogClose      = FOUR_CHAR_CODE('dlgc'),
      kThemeSoundAlertOpen        = FOUR_CHAR_CODE('aopn'),
      kThemeSoundAlertClose       = FOUR_CHAR_CODE('altc'),
      kThemeSoundPopupWindowOpen  = FOUR_CHAR_CODE('pwop'),
      kThemeSoundPopupWindowClose = FOUR_CHAR_CODE('pwcl'),
      kThemeSoundButtonPress      = FOUR_CHAR_CODE('btnp'),       /* button */
      kThemeSoundButtonEnter      = FOUR_CHAR_CODE('btne'),
      kThemeSoundButtonExit       = FOUR_CHAR_CODE('btnx'),
      kThemeSoundButtonRelease    = FOUR_CHAR_CODE('btnr'),
      kThemeSoundDefaultButtonPress = FOUR_CHAR_CODE('dbtp'),     /* default button */
      kThemeSoundDefaultButtonEnter = FOUR_CHAR_CODE('dbte'),
      kThemeSoundDefaultButtonExit = FOUR_CHAR_CODE('dbtx'),
      kThemeSoundDefaultButtonRelease = FOUR_CHAR_CODE('dbtr'),
      kThemeSoundCancelButtonPress = FOUR_CHAR_CODE('cbtp'),      /* cancel button */
      kThemeSoundCancelButtonEnter = FOUR_CHAR_CODE('cbte'),
      kThemeSoundCancelButtonExit = FOUR_CHAR_CODE('cbtx'),
      kThemeSoundCancelButtonRelease = FOUR_CHAR_CODE('cbtr'),
      kThemeSoundCheckboxPress    = FOUR_CHAR_CODE('chkp'),       /* checkboxes */
      kThemeSoundCheckboxEnter    = FOUR_CHAR_CODE('chke'),
      kThemeSoundCheckboxExit     = FOUR_CHAR_CODE('chkx'),
      kThemeSoundCheckboxRelease  = FOUR_CHAR_CODE('chkr'),
      kThemeSoundRadioPress       = FOUR_CHAR_CODE('radp'),       /* radio buttons */
      kThemeSoundRadioEnter       = FOUR_CHAR_CODE('rade'),
      kThemeSoundRadioExit        = FOUR_CHAR_CODE('radx'),
      kThemeSoundRadioRelease     = FOUR_CHAR_CODE('radr'),
      kThemeSoundScrollArrowPress = FOUR_CHAR_CODE('sbap'),       /* scroll bars */
      kThemeSoundScrollArrowEnter = FOUR_CHAR_CODE('sbae'),
      kThemeSoundScrollArrowExit  = FOUR_CHAR_CODE('sbax'),
      kThemeSoundScrollArrowRelease = FOUR_CHAR_CODE('sbar'),
      kThemeSoundScrollEndOfTrack = FOUR_CHAR_CODE('sbte'),
      kThemeSoundScrollTrackPress = FOUR_CHAR_CODE('sbtp'),
      kThemeSoundSliderEndOfTrack = FOUR_CHAR_CODE('slte'),       /* sliders */
      kThemeSoundSliderTrackPress = FOUR_CHAR_CODE('sltp'),
      kThemeSoundBalloonOpen      = FOUR_CHAR_CODE('blno'),       /* help balloons */
      kThemeSoundBalloonClose     = FOUR_CHAR_CODE('blnc'),
      kThemeSoundBevelPress       = FOUR_CHAR_CODE('bevp'),       /* Bevel buttons */
      kThemeSoundBevelEnter       = FOUR_CHAR_CODE('beve'),
      kThemeSoundBevelExit        = FOUR_CHAR_CODE('bevx'),
      kThemeSoundBevelRelease     = FOUR_CHAR_CODE('bevr'),
      kThemeSoundLittleArrowUpPress = FOUR_CHAR_CODE('laup'),     /* Little Arrows */
      kThemeSoundLittleArrowDnPress = FOUR_CHAR_CODE('ladp'),
      kThemeSoundLittleArrowEnter = FOUR_CHAR_CODE('lare'),
      kThemeSoundLittleArrowExit  = FOUR_CHAR_CODE('larx'),
      kThemeSoundLittleArrowUpRelease = FOUR_CHAR_CODE('laur'),
      kThemeSoundLittleArrowDnRelease = FOUR_CHAR_CODE('ladr'),
      kThemeSoundPopupPress       = FOUR_CHAR_CODE('popp'),       /* Popup Buttons */
      kThemeSoundPopupEnter       = FOUR_CHAR_CODE('pope'),
      kThemeSoundPopupExit        = FOUR_CHAR_CODE('popx'),
      kThemeSoundPopupRelease     = FOUR_CHAR_CODE('popr'),
      kThemeSoundDisclosurePress  = FOUR_CHAR_CODE('dscp'),       /* Disclosure Buttons */
      kThemeSoundDisclosureEnter  = FOUR_CHAR_CODE('dsce'),
      kThemeSoundDisclosureExit   = FOUR_CHAR_CODE('dscx'),
      kThemeSoundDisclosureRelease = FOUR_CHAR_CODE('dscr'),
      kThemeSoundTabPressed       = FOUR_CHAR_CODE('tabp'),       /* Tabs */
      kThemeSoundTabEnter         = FOUR_CHAR_CODE('tabe'),
      kThemeSoundTabExit          = FOUR_CHAR_CODE('tabx'),
      kThemeSoundTabRelease       = FOUR_CHAR_CODE('tabr'),
      kThemeSoundDragTargetHilite = FOUR_CHAR_CODE('dthi'),       /* drag manager */
      kThemeSoundDragTargetUnhilite = FOUR_CHAR_CODE('dtuh'),
      kThemeSoundDragTargetDrop   = FOUR_CHAR_CODE('dtdr'),
      kThemeSoundEmptyTrash       = FOUR_CHAR_CODE('ftrs'),       /* finder */
      kThemeSoundSelectItem       = FOUR_CHAR_CODE('fsel'),
      kThemeSoundNewItem          = FOUR_CHAR_CODE('fnew'),
      kThemeSoundReceiveDrop      = FOUR_CHAR_CODE('fdrp'),
      kThemeSoundCopyDone         = FOUR_CHAR_CODE('fcpd'),
      kThemeSoundResolveAlias     = FOUR_CHAR_CODE('fral'),
      kThemeSoundLaunchApp        = FOUR_CHAR_CODE('flap'),
      kThemeSoundDiskInsert       = FOUR_CHAR_CODE('dski'),
      kThemeSoundDiskEject        = FOUR_CHAR_CODE('dske'),
      kThemeSoundFinderDragOnIcon = FOUR_CHAR_CODE('fdon'),
      kThemeSoundFinderDragOffIcon = FOUR_CHAR_CODE('fdof')
  };
  
  typedef OSType                          ThemeSoundKind;
  /*------------------------------------------------------------------------------------------*/
  /* Window Metrics                                                                           */
  /*------------------------------------------------------------------------------------------*/
  /*  Window metrics are used by the Appearance manager to fill in the blanks necessary to    */
  /*  draw windows. If a value is not appropriate for the type of window, be sure to fill in  */
  /*  the slot in the structure with zero.    For the popupTabOffset parameter, you can pass a*/
  /*  real value based on the left edge of the window. This value might be interpreted in a   */
  /*  different manner when depending on the value of the popupTabPosition field. The values  */
  /*  you can pass into popupTabPosition are:                                                 */
  /*                                                                                          */
  /*  kThemePopupTabNormalPosition                                                            */
  /*      Starts the tab left edge at the position indicated by the popupTabOffset field.     */
  /*                                                                                          */
  /*  kThemePopupTabCenterOnWindow                                                            */
  /*      tells us to ignore the offset field and instead simply center the width of the      */
  /*      handle on the window.                                                               */
  /*                                                                                          */
  /*  kThemePopupTabCenterOnOffset                                                            */
  /*      tells us to center the width of the handle around the value passed in offset.       */
  /*                                                                                          */
  /*  The Appearance Manager will try its best to accomodate the requested placement, but may */
  /*  move the handle slightly to make it fit correctly.                                      */
  /*                                                                                          */
  enum {
      kThemePopupTabNormalPosition = 0,
      kThemePopupTabCenterOnWindow = 1,
      kThemePopupTabCenterOnOffset = 2
  };
  
  struct ThemeWindowMetrics {
      UInt16                          metricSize;                 /* should be always be sizeof( ThemeWindowMetrics )*/
      SInt16                          titleHeight;
      SInt16                          titleWidth;
      SInt16                          popupTabOffset;
      SInt16                          popupTabWidth;
      UInt16                          popupTabPosition;
  };
  typedef struct ThemeWindowMetrics       ThemeWindowMetrics;
  typedef ThemeWindowMetrics *            ThemeWindowMetricsPtr;
  /*------------------------------------------------------------------------------------------*/
  /* Theme Metrics                                                                            */
  /*------------------------------------------------------------------------------------------*/
  /*  Theme metrics allow you to find out sizes of things in the current environment, such as */
  /*  how wide a scroll bar is, etc.                                                          */
  enum {
      kThemeMetricScrollBarWidth  = 0,
      kThemeMetricSmallScrollBarWidth = 1,
      kThemeMetricCheckBoxGlyphHeight = 2,
      kThemeMetricRadioButtonGlyphHeight = 3
  };
  
  typedef UInt32                          ThemeMetric;
  /*------------------------------------------------------------------------------------------*/
  /* Drawing State                                                                            */
  /*------------------------------------------------------------------------------------------*/
  typedef struct OpaqueThemeDrawingState*  ThemeDrawingState;
  /*------------------------------------------------------------------------------------------*/
  /* Callback procs                                                                           */
  /*------------------------------------------------------------------------------------------*/
  typedef CALLBACK_API( void , ThemeTabTitleDrawProcPtr )(const Rect *bounds, ThemeTabStyle style, ThemeTabDirection direction, SInt16 depth, Boolean isColorDev, UInt32 userData);
  typedef CALLBACK_API( void , ThemeEraseProcPtr )(const Rect *bounds, UInt32 eraseData, SInt16 depth, Boolean isColorDev);
  typedef CALLBACK_API( void , ThemeButtonDrawProcPtr )(const Rect *bounds, ThemeButtonKind kind, const ThemeButtonDrawInfo *info, UInt32 userData, SInt16 depth, Boolean isColorDev);
  typedef CALLBACK_API( void , WindowTitleDrawingProcPtr )(const Rect *bounds, SInt16 depth, Boolean colorDevice, UInt32 userData);
  typedef CALLBACK_API( Boolean , ThemeIteratorProcPtr )(ConstStr255Param inFileName, SInt16 resID, Collection inThemeSettings, void *inUserData);
  typedef STACK_UPP_TYPE(ThemeTabTitleDrawProcPtr)                ThemeTabTitleDrawUPP;
  typedef STACK_UPP_TYPE(ThemeEraseProcPtr)                       ThemeEraseUPP;
  typedef STACK_UPP_TYPE(ThemeButtonDrawProcPtr)                  ThemeButtonDrawUPP;
  typedef STACK_UPP_TYPE(WindowTitleDrawingProcPtr)               WindowTitleDrawingUPP;
  typedef STACK_UPP_TYPE(ThemeIteratorProcPtr)                    ThemeIteratorUPP;
  if OPAQUE_UPP_TYPES
      EXTERN_API(ThemeTabTitleDrawUPP)
      NewThemeTabTitleDrawUPP        (ThemeTabTitleDrawProcPtr userRoutine);
  
      EXTERN_API(ThemeEraseUPP)
      NewThemeEraseUPP               (ThemeEraseProcPtr       userRoutine);
  
      EXTERN_API(ThemeButtonDrawUPP)
      NewThemeButtonDrawUPP          (ThemeButtonDrawProcPtr  userRoutine);
  
      EXTERN_API(WindowTitleDrawingUPP)
      NewWindowTitleDrawingUPP       (WindowTitleDrawingProcPtr userRoutine);
  
      EXTERN_API(ThemeIteratorUPP)
      NewThemeIteratorUPP            (ThemeIteratorProcPtr    userRoutine);
  
      EXTERN_API(void)
      DisposeThemeTabTitleDrawUPP    (ThemeTabTitleDrawUPP    userUPP);
  
      EXTERN_API(void)
      DisposeThemeEraseUPP           (ThemeEraseUPP           userUPP);
  
      EXTERN_API(void)
      DisposeThemeButtonDrawUPP      (ThemeButtonDrawUPP      userUPP);
  
      EXTERN_API(void)
      DisposeWindowTitleDrawingUPP    (WindowTitleDrawingUPP  userUPP);
  
      EXTERN_API(void)
      DisposeThemeIteratorUPP        (ThemeIteratorUPP        userUPP);
  
      EXTERN_API(void)
      InvokeThemeTabTitleDrawUPP     (const Rect *            bounds,
                                      ThemeTabStyle           style,
                                      ThemeTabDirection       direction,
                                      SInt16                  depth,
                                      Boolean                 isColorDev,
                                      UInt32                  userData,
                                      ThemeTabTitleDrawUPP    userUPP);
  
      EXTERN_API(void)
      InvokeThemeEraseUPP            (const Rect *            bounds,
                                      UInt32                  eraseData,
                                      SInt16                  depth,
                                      Boolean                 isColorDev,
                                      ThemeEraseUPP           userUPP);
  
      EXTERN_API(void)
      InvokeThemeButtonDrawUPP       (const Rect *            bounds,
                                      ThemeButtonKind         kind,
                                      const ThemeButtonDrawInfo * info,
                                      UInt32                  userData,
                                      SInt16                  depth,
                                      Boolean                 isColorDev,
                                      ThemeButtonDrawUPP      userUPP);
  
      EXTERN_API(void)
      InvokeWindowTitleDrawingUPP    (const Rect *            bounds,
                                      SInt16                  depth,
                                      Boolean                 colorDevice,
                                      UInt32                  userData,
                                      WindowTitleDrawingUPP   userUPP);
  
      EXTERN_API(Boolean)
      InvokeThemeIteratorUPP         (ConstStr255Param        inFileName,
                                      SInt16                  resID,
                                      Collection              inThemeSettings,
                                      void *                  inUserData,
                                      ThemeIteratorUPP        userUPP);
  
  else
      enum { uppThemeTabTitleDrawProcInfo = 0x00036AC0 };             /* pascal no_return_value Func(4_bytes, 2_bytes, 2_bytes, 2_bytes, 1_byte, 4_bytes) */
      enum { uppThemeEraseProcInfo = 0x00001BC0 };                    /* pascal no_return_value Func(4_bytes, 4_bytes, 2_bytes, 1_byte) */
      enum { uppThemeButtonDrawProcInfo = 0x0001BEC0 };               /* pascal no_return_value Func(4_bytes, 2_bytes, 4_bytes, 4_bytes, 2_bytes, 1_byte) */
      enum { uppWindowTitleDrawingProcInfo = 0x000036C0 };            /* pascal no_return_value Func(4_bytes, 2_bytes, 1_byte, 4_bytes) */
      enum { uppThemeIteratorProcInfo = 0x00003ED0 };                 /* pascal 1_byte Func(4_bytes, 2_bytes, 4_bytes, 4_bytes) */
      #define NewThemeTabTitleDrawUPP(userRoutine)                    (ThemeTabTitleDrawUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppThemeTabTitleDrawProcInfo, GetCurrentArchitecture())
      #define NewThemeEraseUPP(userRoutine)                           (ThemeEraseUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppThemeEraseProcInfo, GetCurrentArchitecture())
      #define NewThemeButtonDrawUPP(userRoutine)                      (ThemeButtonDrawUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppThemeButtonDrawProcInfo, GetCurrentArchitecture())
      #define NewWindowTitleDrawingUPP(userRoutine)                   (WindowTitleDrawingUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppWindowTitleDrawingProcInfo, GetCurrentArchitecture())
      #define NewThemeIteratorUPP(userRoutine)                        (ThemeIteratorUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppThemeIteratorProcInfo, GetCurrentArchitecture())
      #define DisposeThemeTabTitleDrawUPP(userUPP)                    DisposeRoutineDescriptor(userUPP)
      #define DisposeThemeEraseUPP(userUPP)                           DisposeRoutineDescriptor(userUPP)
      #define DisposeThemeButtonDrawUPP(userUPP)                      DisposeRoutineDescriptor(userUPP)
      #define DisposeWindowTitleDrawingUPP(userUPP)                   DisposeRoutineDescriptor(userUPP)
      #define DisposeThemeIteratorUPP(userUPP)                        DisposeRoutineDescriptor(userUPP)
      #define InvokeThemeTabTitleDrawUPP(bounds, style, direction, depth, isColorDev, userData, userUPP)  CALL_SIX_PARAMETER_UPP((userUPP), uppThemeTabTitleDrawProcInfo, (bounds), (style), (direction), (depth), (isColorDev), (userData))
      #define InvokeThemeEraseUPP(bounds, eraseData, depth, isColorDev, userUPP)  CALL_FOUR_PARAMETER_UPP((userUPP), uppThemeEraseProcInfo, (bounds), (eraseData), (depth), (isColorDev))
      #define InvokeThemeButtonDrawUPP(bounds, kind, info, userData, depth, isColorDev, userUPP)  CALL_SIX_PARAMETER_UPP((userUPP), uppThemeButtonDrawProcInfo, (bounds), (kind), (info), (userData), (depth), (isColorDev))
      #define InvokeWindowTitleDrawingUPP(bounds, depth, colorDevice, userData, userUPP)  CALL_FOUR_PARAMETER_UPP((userUPP), uppWindowTitleDrawingProcInfo, (bounds), (depth), (colorDevice), (userData))
      #define InvokeThemeIteratorUPP(inFileName, resID, inThemeSettings, inUserData, userUPP)  (Boolean)CALL_FOUR_PARAMETER_UPP((userUPP), uppThemeIteratorProcInfo, (inFileName), (resID), (inThemeSettings), (inUserData))
  endif
  /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  define NewThemeTabTitleDrawProc(userRoutine)                   NewThemeTabTitleDrawUPP(userRoutine)
  define NewThemeEraseProc(userRoutine)                          NewThemeEraseUPP(userRoutine)
  define NewThemeButtonDrawProc(userRoutine)                     NewThemeButtonDrawUPP(userRoutine)
  define NewWindowTitleDrawingProc(userRoutine)                  NewWindowTitleDrawingUPP(userRoutine)
  define NewThemeIteratorProc(userRoutine)                       NewThemeIteratorUPP(userRoutine)
  define CallThemeTabTitleDrawProc(userRoutine, bounds, style, direction, depth, isColorDev, userData) InvokeThemeTabTitleDrawUPP(bounds, style, direction, depth, isColorDev, userData, userRoutine)
  define CallThemeEraseProc(userRoutine, bounds, eraseData, depth, isColorDev) InvokeThemeEraseUPP(bounds, eraseData, depth, isColorDev, userRoutine)
  define CallThemeButtonDrawProc(userRoutine, bounds, kind, info, userData, depth, isColorDev) InvokeThemeButtonDrawUPP(bounds, kind, info, userData, depth, isColorDev, userRoutine)
  define CallWindowTitleDrawingProc(userRoutine, bounds, depth, colorDevice, userData) InvokeWindowTitleDrawingUPP(bounds, depth, colorDevice, userData, userRoutine)
  define CallThemeIteratorProc(userRoutine, inFileName, resID, inThemeSettings, inUserData) InvokeThemeIteratorUPP(inFileName, resID, inThemeSettings, inUserData, userRoutine)
  /*----------------------------------------------------------------------------------*/
  /* Menu Drawing callbacks                                                           */
  /*----------------------------------------------------------------------------------*/
  typedef CALLBACK_API( void , MenuTitleDrawingProcPtr )(const Rect *inBounds, SInt16 inDepth, Boolean inIsColorDevice, SInt32 inUserData);
  typedef CALLBACK_API( void , MenuItemDrawingProcPtr )(const Rect *inBounds, SInt16 inDepth, Boolean inIsColorDevice, SInt32 inUserData);
  typedef STACK_UPP_TYPE(MenuTitleDrawingProcPtr)                 MenuTitleDrawingUPP;
  typedef STACK_UPP_TYPE(MenuItemDrawingProcPtr)                  MenuItemDrawingUPP;
  if OPAQUE_UPP_TYPES
      EXTERN_API(MenuTitleDrawingUPP)
      NewMenuTitleDrawingUPP         (MenuTitleDrawingProcPtr userRoutine);
  
      EXTERN_API(MenuItemDrawingUPP)
      NewMenuItemDrawingUPP          (MenuItemDrawingProcPtr  userRoutine);
  
      EXTERN_API(void)
      DisposeMenuTitleDrawingUPP     (MenuTitleDrawingUPP     userUPP);
  
      EXTERN_API(void)
      DisposeMenuItemDrawingUPP      (MenuItemDrawingUPP      userUPP);
  
      EXTERN_API(void)
      InvokeMenuTitleDrawingUPP      (const Rect *            inBounds,
                                      SInt16                  inDepth,
                                      Boolean                 inIsColorDevice,
                                      SInt32                  inUserData,
                                      MenuTitleDrawingUPP     userUPP);
  
      EXTERN_API(void)
      InvokeMenuItemDrawingUPP       (const Rect *            inBounds,
                                      SInt16                  inDepth,
                                      Boolean                 inIsColorDevice,
                                      SInt32                  inUserData,
                                      MenuItemDrawingUPP      userUPP);
  
  else
      enum { uppMenuTitleDrawingProcInfo = 0x000036C0 };              /* pascal no_return_value Func(4_bytes, 2_bytes, 1_byte, 4_bytes) */
      enum { uppMenuItemDrawingProcInfo = 0x000036C0 };               /* pascal no_return_value Func(4_bytes, 2_bytes, 1_byte, 4_bytes) */
      #define NewMenuTitleDrawingUPP(userRoutine)                     (MenuTitleDrawingUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppMenuTitleDrawingProcInfo, GetCurrentArchitecture())
      #define NewMenuItemDrawingUPP(userRoutine)                      (MenuItemDrawingUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppMenuItemDrawingProcInfo, GetCurrentArchitecture())
      #define DisposeMenuTitleDrawingUPP(userUPP)                     DisposeRoutineDescriptor(userUPP)
      #define DisposeMenuItemDrawingUPP(userUPP)                      DisposeRoutineDescriptor(userUPP)
      #define InvokeMenuTitleDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, userUPP)  CALL_FOUR_PARAMETER_UPP((userUPP), uppMenuTitleDrawingProcInfo, (inBounds), (inDepth), (inIsColorDevice), (inUserData))
      #define InvokeMenuItemDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, userUPP)  CALL_FOUR_PARAMETER_UPP((userUPP), uppMenuItemDrawingProcInfo, (inBounds), (inDepth), (inIsColorDevice), (inUserData))
  endif
  /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  define NewMenuTitleDrawingProc(userRoutine)                    NewMenuTitleDrawingUPP(userRoutine)
  define NewMenuItemDrawingProc(userRoutine)                     NewMenuItemDrawingUPP(userRoutine)
  define CallMenuTitleDrawingProc(userRoutine, inBounds, inDepth, inIsColorDevice, inUserData) InvokeMenuTitleDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, userRoutine)
  define CallMenuItemDrawingProc(userRoutine, inBounds, inDepth, inIsColorDevice, inUserData) InvokeMenuItemDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, userRoutine)
  /*----------------------------------------------------------------------------------*/
  /*  Appearance Manager APIs                                                         */
  /*----------------------------------------------------------------------------------*/
  /* Registering Appearance-Savvy Applications */
  EXTERN_API( OSStatus )
  RegisterAppearanceClient        (void)                                                      THREEWORDINLINE(0x303C, 0x0015, 0xAA74);
  
  EXTERN_API( OSStatus )
  UnregisterAppearanceClient      (void)                                                      THREEWORDINLINE(0x303C, 0x0016, 0xAA74);
  
  EXTERN_API( Boolean )
  IsAppearanceClient              (const ProcessSerialNumber * process)                       THREEWORDINLINE(0x303C, 0xFFFF, 0xAA74);