Mac OS 9
Appearance.h File Reference

Appearance Manager Interfaces. More...

#include <MacTypes.h>
#include <Quickdraw.h>
#include <TextEdit.h>

Go to the source code of this file.

Data Structures

struct  ScrollBarTrackInfo
 
struct  SliderTrackInfo
 
struct  ProgressTrackInfo
 
struct  ThemeTrackDrawInfo
 
struct  ThemeButtonDrawInfo
 
struct  ThemeWindowMetrics
 

Macros

#define kThemeAppearancePlatinum   CFSTR("com.apple.theme.appearance.platinum")
 
#define kThemeAppearanceAqua   CFSTR("com.apple.theme.appearance.aqua")
 
#define kThemeAppearanceAquaBlue   CFSTR("com.apple.theme.appearance.aqua.blue")
 
#define kThemeAppearanceAquaGraphite    CFSTR("com.apple.theme.appearance.aqua.graphite")
 
#define NewThemeTabTitleDrawUPP(userRoutine)
 
#define NewThemeEraseUPP(userRoutine)
 
#define NewThemeButtonDrawUPP(userRoutine)
 
#define NewWindowTitleDrawingUPP(userRoutine)
 
#define NewThemeIteratorUPP(userRoutine)
 
#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)
 
#define InvokeThemeEraseUPP(bounds, eraseData, depth, isColorDev, userUPP)
 
#define InvokeThemeButtonDrawUPP(bounds, kind, info, userData, depth, isColorDev, userUPP)
 
#define InvokeWindowTitleDrawingUPP(bounds, depth, colorDevice, userData, userUPP)
 
#define InvokeThemeIteratorUPP(inFileName, resID, inThemeSettings, inUserData, userUPP)
 
#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)
 
#define CallThemeEraseProc(userRoutine, bounds, eraseData, depth, isColorDev)    InvokeThemeEraseUPP(bounds, eraseData, depth, isColorDev, userRoutine)
 
#define CallThemeButtonDrawProc(userRoutine, bounds, kind, info, userData, depth, isColorDev)
 
#define CallWindowTitleDrawingProc(userRoutine, bounds, depth, colorDevice, userData)    InvokeWindowTitleDrawingUPP(bounds, depth, colorDevice, userData, userRoutine)
 
#define CallThemeIteratorProc(userRoutine, inFileName, resID, inThemeSettings, inUserData)
 
#define NewMenuTitleDrawingUPP(userRoutine)
 
#define NewMenuItemDrawingUPP(userRoutine)
 
#define DisposeMenuTitleDrawingUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define DisposeMenuItemDrawingUPP(userUPP)   DisposeRoutineDescriptor(userUPP)
 
#define InvokeMenuTitleDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, userUPP)
 
#define InvokeMenuItemDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, userUPP)
 
#define NewMenuTitleDrawingProc(userRoutine)   NewMenuTitleDrawingUPP(userRoutine)
 
#define NewMenuItemDrawingProc(userRoutine)   NewMenuItemDrawingUPP(userRoutine)
 
#define CallMenuTitleDrawingProc(userRoutine, inBounds, inDepth, inIsColorDevice, inUserData)
 
#define CallMenuItemDrawingProc(userRoutine, inBounds, inDepth, inIsColorDevice, inUserData)
 

Typedefs

typedef SInt16 ThemeBrush
 
typedef SInt16 ThemeTextColor
 
typedef UInt32 ThemeDrawState
 
typedef UInt32 ThemeCursor
 
typedef UInt16 ThemeMenuBarState
 
typedef UInt16 ThemeMenuState
 
typedef UInt16 ThemeMenuType
 
typedef UInt16 ThemeMenuItemType
 
typedef UInt32 ThemeBackgroundKind
 
typedef UInt16 ThemeCheckBoxStyle
 
typedef UInt16 ThemeScrollBarArrowStyle
 
typedef UInt16 ThemeScrollBarThumbStyle
 
typedef UInt16 ThemeFontID
 
typedef UInt16 ThemeTabStyle
 
typedef UInt16 ThemeTabDirection
 
typedef UInt16 ThemeTrackKind
 
typedef UInt8 ThemeTrackEnableState
 
typedef UInt8 ThemeTrackPressState
 
typedef UInt8 ThemeThumbDirection
 
typedef UInt16 ThemeTrackAttributes
 
typedef struct ScrollBarTrackInfo ScrollBarTrackInfo
 
typedef struct SliderTrackInfo SliderTrackInfo
 
typedef struct ProgressTrackInfo ProgressTrackInfo
 
typedef struct ThemeTrackDrawInfo ThemeTrackDrawInfo
 
typedef UInt32 ThemeWindowAttributes
 
typedef UInt16 ThemeWindowType
 
typedef UInt16 ThemeTitleBarWidget
 
typedef UInt16 ThemeArrowOrientation
 
typedef UInt16 ThemePopupArrowSize
 
typedef UInt16 ThemeGrowDirection
 
typedef UInt16 ThemeButtonKind
 
typedef UInt16 ThemeButtonValue
 
typedef UInt16 ThemeButtonAdornment
 
typedef struct ThemeButtonDrawInfo ThemeButtonDrawInfo
 
typedef ThemeButtonDrawInfoThemeButtonDrawInfoPtr
 
typedef OSType ThemeDragSoundKind
 
typedef OSType ThemeSoundKind
 
typedef struct ThemeWindowMetrics ThemeWindowMetrics
 
typedef ThemeWindowMetricsThemeWindowMetricsPtr
 
typedef UInt32 ThemeMetric
 
typedef struct OpaqueThemeDrawingState * ThemeDrawingState
 
typedef ThemeTabStyle style
 
typedef ThemeTabStyle ThemeTabDirection direction
 
typedef ThemeTabStyle ThemeTabDirection SInt16 depth
 
typedef ThemeTabStyle ThemeTabDirection SInt16 Boolean isColorDev
 
typedef ThemeTabStyle ThemeTabDirection SInt16 Boolean UInt32 userData
 
typedef UInt32 eraseData
 
typedef ThemeButtonKind kind
 
typedef ThemeButtonKind const ThemeButtonDrawInfoinfo
 
typedef SInt16 Boolean colorDevice
 
typedef SInt16 resID
 
typedef SInt16 Collection inThemeSettings
 
typedef SInt16 Collection void * inUserData
 
typedef SInt16 inDepth
 
typedef SInt16 Boolean inIsColorDevice
 

Enumerations

enum  {
  kAppearanceEventClass = FOUR_CHAR_CODE('appr') , kAEAppearanceChanged , kAESystemFontChanged = FOUR_CHAR_CODE('sysf') , kAESmallSystemFontChanged ,
  kAEViewsFontChanged = FOUR_CHAR_CODE('vfnt')
}
 
enum  { kThemeDataFileType = FOUR_CHAR_CODE('thme') , kThemePlatinumFileType , kThemeCustomThemesFileType , kThemeSoundTrackFileType = FOUR_CHAR_CODE('tsnd') }
 
enum  {
  kThemeBrushDialogBackgroundActive = 1 , kThemeBrushDialogBackgroundInactive = 2 , kThemeBrushAlertBackgroundActive = 3 , kThemeBrushAlertBackgroundInactive = 4 ,
  kThemeBrushModelessDialogBackgroundActive = 5 , kThemeBrushModelessDialogBackgroundInactive = 6 , kThemeBrushUtilityWindowBackgroundActive = 7 , kThemeBrushUtilityWindowBackgroundInactive = 8 ,
  kThemeBrushListViewSortColumnBackground = 9 , kThemeBrushListViewBackground = 10 , kThemeBrushIconLabelBackground = 11 , kThemeBrushListViewSeparator = 12 ,
  kThemeBrushChasingArrows = 13 , kThemeBrushDragHilite = 14 , kThemeBrushDocumentWindowBackground = 15 , kThemeBrushFinderWindowBackground = 16
}
 
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
}
 
enum  { kThemeBrushNotificationWindowBackground = 48 }
 
enum  {
  kThemeBrushMovableModalBackground = 49 , kThemeBrushSheetBackgroundOpaque = 50 , kThemeBrushDrawerBackground = 51 , kThemeBrushToolbarBackground = 52 ,
  kThemeBrushSheetBackgroundTransparent = 53
}
 
enum  { kThemeBrushSheetBackground = kThemeBrushSheetBackgroundOpaque }
 
enum  { kThemeBrushBlack = -1 , kThemeBrushWhite = -2 }
 
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
}
 
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
}
 
enum  {
  kThemeTextColorTabFrontActive = 39 , kThemeTextColorTabNonFrontActive = 40 , kThemeTextColorTabNonFrontPressed = 41 , kThemeTextColorTabFrontInactive = 42 ,
  kThemeTextColorTabNonFrontInactive = 43 , kThemeTextColorIconLabelSelected = 44 , kThemeTextColorBevelButtonStickyActive = 45 , kThemeTextColorBevelButtonStickyInactive = 46
}
 
enum  { kThemeTextColorNotification = 47 }
 
enum  { kThemeTextColorBlack = -1 , kThemeTextColorWhite = -2 }
 
enum  {
  kThemeStateInactive = 0 , kThemeStateActive = 1 , kThemeStatePressed = 2 , kThemeStateRollover = 6 ,
  kThemeStateUnavailable = 7 , kThemeStateUnavailableInactive = 8
}
 
enum  { kThemeStateDisabled = 0 }
 
enum  { kThemeStatePressedUp , kThemeStatePressedDown }
 
enum  {
  kThemeArrowCursor = 0 , kThemeCopyArrowCursor = 1 , kThemeAliasArrowCursor = 2 , kThemeContextualMenuArrowCursor = 3 ,
  kThemeIBeamCursor = 4 , kThemeCrossCursor = 5 , kThemePlusCursor = 6 , kThemeWatchCursor = 7 ,
  kThemeClosedHandCursor = 8 , kThemeOpenHandCursor = 9 , kThemePointingHandCursor = 10 , kThemeCountingUpHandCursor = 11 ,
  kThemeCountingDownHandCursor = 12 , kThemeCountingUpAndDownHandCursor = 13 , kThemeSpinningCursor = 14 , kThemeResizeLeftCursor = 15 ,
  kThemeResizeRightCursor = 16 , kThemeResizeLeftRightCursor = 17
}
 
enum  { kThemeMenuBarNormal = 0 , kThemeMenuBarSelected = 1 }
 
enum  { kThemeMenuSquareMenuBar = (1 << 0) }
 
enum  { kThemeMenuActive = 0 , kThemeMenuSelected = 1 , kThemeMenuDisabled = 3 }
 
enum  { kThemeMenuTypePullDown = 0 , kThemeMenuTypePopUp = 1 , kThemeMenuTypeHierarchical = 2 , kThemeMenuTypeInactive = 0x0100 }
 
enum  {
  kThemeMenuItemPlain = 0 , kThemeMenuItemHierarchical = 1 , kThemeMenuItemScrollUpArrow , kThemeMenuItemScrollDownArrow = 3 ,
  kThemeMenuItemAtTop , kThemeMenuItemAtBottom , kThemeMenuItemHierBackground = 0x0400 , kThemeMenuItemPopUpBackground = 0x0800 ,
  kThemeMenuItemHasIcon = 0x8000 , kThemeMenuItemNoBackground = 0x4000
}
 
enum  {
  kThemeBackgroundTabPane = 1 , kThemeBackgroundPlacard = 2 , kThemeBackgroundWindowHeader = 3 , kThemeBackgroundListViewWindowHeader = 4 ,
  kThemeBackgroundSecondaryGroupBox = 5
}
 
enum  {
  kThemeNameTag = FOUR_CHAR_CODE('name') , kThemeVariantNameTag = FOUR_CHAR_CODE('varn') , kThemeVariantBaseTintTag , kThemeHighlightColorTag = FOUR_CHAR_CODE('hcol') ,
  kThemeScrollBarArrowStyleTag , kThemeScrollBarThumbStyleTag , kThemeSoundsEnabledTag = FOUR_CHAR_CODE('snds') , kThemeDblClickCollapseTag = FOUR_CHAR_CODE('coll')
}
 
enum  {
  kThemeAppearanceFileNameTag = FOUR_CHAR_CODE('thme') , kThemeSystemFontTag = FOUR_CHAR_CODE('lgsf') , kThemeSmallSystemFontTag = FOUR_CHAR_CODE('smsf') , kThemeViewsFontTag = FOUR_CHAR_CODE('vfnt') ,
  kThemeViewsFontSizeTag = FOUR_CHAR_CODE('vfsz') , kThemeDesktopPatternNameTag = FOUR_CHAR_CODE('patn') , kThemeDesktopPatternTag , kThemeDesktopPictureNameTag = FOUR_CHAR_CODE('dpnm') ,
  kThemeDesktopPictureAliasTag = FOUR_CHAR_CODE('dpal') , kThemeDesktopPictureAlignmentTag , kThemeHighlightColorNameTag = FOUR_CHAR_CODE('hcnm') , kThemeExamplePictureIDTag = FOUR_CHAR_CODE('epic') ,
  kThemeSoundTrackNameTag = FOUR_CHAR_CODE('sndt') , kThemeSoundMaskTag = FOUR_CHAR_CODE('smsk') , kThemeUserDefinedTag , kThemeSmoothFontEnabledTag = FOUR_CHAR_CODE('smoo') ,
  kThemeSmoothFontMinSizeTag
}
 
enum  {
  kTiledOnScreen = 1 , kCenterOnScreen = 2 , kFitToScreen = 3 , kFillScreen = 4 ,
  kUseBestGuess = 5
}
 
enum  { kThemeCheckBoxClassicX = 0 , kThemeCheckBoxCheckMark = 1 }
 
enum  { kThemeScrollBarArrowsSingle = 0 , kThemeScrollBarArrowsLowerRight = 1 }
 
enum  { kThemeScrollBarThumbNormal = 0 , kThemeScrollBarThumbProportional = 1 }
 
enum  {
  kThemeSystemFont = 0 , kThemeSmallSystemFont = 1 , kThemeSmallEmphasizedSystemFont = 2 , kThemeViewsFont = 3 ,
  kThemeEmphasizedSystemFont = 4 , kThemeApplicationFont = 5 , kThemeLabelFont = 6 , kThemeMenuTitleFont = 100 ,
  kThemeMenuItemFont = 101 , kThemeMenuItemMarkFont = 102 , kThemeMenuItemCmdKeyFont = 103 , kThemeWindowTitleFont = 104 ,
  kThemePushButtonFont = 105 , kThemeUtilityWindowTitleFont = 106 , kThemeAlertHeaderFont = 107 , kThemeCurrentPortFont = 200
}
 
enum  {
  kThemeTabNonFront = 0 , kThemeTabNonFrontPressed = 1 , kThemeTabNonFrontInactive = 2 , kThemeTabFront = 3 ,
  kThemeTabFrontInactive = 4 , kThemeTabNonFrontUnavailable = 5 , kThemeTabFrontUnavailable = 6
}
 
enum  { kThemeTabNorth = 0 , kThemeTabSouth = 1 , kThemeTabEast = 2 , kThemeTabWest = 3 }
 
enum  {
  kThemeSmallTabHeight = 16 , kThemeLargeTabHeight = 21 , kThemeTabPaneOverlap = 3 , kThemeSmallTabHeightMax = 19 ,
  kThemeLargeTabHeightMax = 24
}
 
enum  {
  kThemeMediumScrollBar = 0 , kThemeSmallScrollBar = 1 , kThemeMediumSlider = 2 , kThemeMediumProgressBar = 3 ,
  kThemeMediumIndeterminateBar = 4 , kThemeRelevanceBar = 5 , kThemeSmallSlider = 6 , kThemeLargeProgressBar = 7 ,
  kThemeLargeIndeterminateBar = 8
}
 
enum  { kThemeTrackActive = 0 , kThemeTrackDisabled = 1 , kThemeTrackNothingToScroll = 2 , kThemeTrackInactive = 3 }
 
enum  {
  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
}
 
enum  { kThemeThumbPlain = 0 , kThemeThumbUpward = 1 , kThemeThumbDownward = 2 }
 
enum  {
  kThemeTrackHorizontal = (1 << 0) , kThemeTrackRightToLeft = (1 << 1) , kThemeTrackShowThumb = (1 << 2) , kThemeTrackThumbRgnIsNotGhost ,
  kThemeTrackNoScrollBarArrows
}
 
enum  {
  kThemeWindowHasGrow , kThemeWindowHasHorizontalZoom , kThemeWindowHasVerticalZoom = (1 << 4) , kThemeWindowHasFullZoom ,
  kThemeWindowHasCloseBox = (1 << 5) , kThemeWindowHasCollapseBox = (1 << 6) , kThemeWindowHasTitleText = (1 << 7) , kThemeWindowIsCollapsed = (1 << 8) ,
  kThemeWindowHasDirty = (1 << 9)
}
 
enum  {
  kThemeDocumentWindow = 0 , kThemeDialogWindow = 1 , kThemeMovableDialogWindow = 2 , kThemeAlertWindow = 3 ,
  kThemeMovableAlertWindow = 4 , kThemePlainDialogWindow = 5 , kThemeShadowDialogWindow = 6 , kThemePopupWindow = 7 ,
  kThemeUtilityWindow = 8 , kThemeUtilitySideWindow = 9 , kThemeSheetWindow = 10
}
 
enum  { kThemeWidgetCloseBox = 0 , kThemeWidgetZoomBox = 1 , kThemeWidgetCollapseBox = 2 , kThemeWidgetDirtyCloseBox = 6 }
 
enum  { kThemeArrowLeft = 0 , kThemeArrowDown = 1 , kThemeArrowRight = 2 , kThemeArrowUp = 3 }
 
enum  { kThemeArrow3pt = 0 , kThemeArrow5pt = 1 , kThemeArrow7pt = 2 , kThemeArrow9pt = 3 }
 
enum  { kThemeGrowLeft = (1 << 0) , kThemeGrowRight = (1 << 1) , kThemeGrowUp = (1 << 2) , kThemeGrowDown = (1 << 3) }
 
enum  {
  kThemePushButton = 0 , kThemeCheckBox = 1 , kThemeRadioButton = 2 , kThemeBevelButton = 3 ,
  kThemeArrowButton = 4 , kThemePopupButton = 5 , kThemeDisclosureButton = 6 , kThemeIncDecButton = 7 ,
  kThemeSmallBevelButton = 8 , kThemeMediumBevelButton = 3 , kThemeLargeBevelButton = 9 , kThemeListHeaderButton = 10 ,
  kThemeRoundButton = 11 , kThemeLargeRoundButton = 12 , kThemeSmallCheckBox = 13 , kThemeSmallRadioButton = 14 ,
  kThemeRoundedBevelButton = 15 , kThemeNormalCheckBox = kThemeCheckBox , kThemeNormalRadioButton = kThemeRadioButton
}
 
enum  {
  kThemeButtonOff = 0 , kThemeButtonOn = 1 , kThemeButtonMixed = 2 , kThemeDisclosureRight = 0 ,
  kThemeDisclosureDown = 1 , kThemeDisclosureLeft = 2
}
 
enum  {
  kThemeAdornmentNone = 0 , kThemeAdornmentDefault = (1 << 0) , kThemeAdornmentFocus = (1 << 2) , kThemeAdornmentRightToLeft = (1 << 4) ,
  kThemeAdornmentDrawIndicatorOnly , kThemeAdornmentHeaderButtonLeftNeighborSelected , kThemeAdornmentHeaderButtonRightNeighborSelected , kThemeAdornmentHeaderButtonSortUp ,
  kThemeAdornmentHeaderMenuButton , kThemeAdornmentHeaderButtonNoShadow , kThemeAdornmentHeaderButtonShadowOnly , kThemeAdornmentNoShadow = kThemeAdornmentHeaderButtonNoShadow ,
  kThemeAdornmentShadowOnly , kThemeAdornmentArrowLeftArrow , kThemeAdornmentArrowDownArrow , kThemeAdornmentArrowDoubleArrow ,
  kThemeAdornmentArrowUpArrow
}
 
enum  {
  kThemeNoSounds = 0 , kThemeWindowSoundsMask = (1 << 0) , kThemeMenuSoundsMask = (1 << 1) , kThemeControlSoundsMask = (1 << 2) ,
  kThemeFinderSoundsMask = (1 << 3)
}
 
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')
}
 
enum  {
  kThemeSoundNone = 0 , kThemeSoundMenuOpen = FOUR_CHAR_CODE('mnuo') , kThemeSoundMenuClose = FOUR_CHAR_CODE('mnuc') , kThemeSoundMenuItemHilite = FOUR_CHAR_CODE('mnui') ,
  kThemeSoundMenuItemRelease = FOUR_CHAR_CODE('mnus') , kThemeSoundWindowClosePress = FOUR_CHAR_CODE('wclp') , 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 , 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 ,
  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') ,
  kThemeSoundButtonEnter = FOUR_CHAR_CODE('btne') , kThemeSoundButtonExit = FOUR_CHAR_CODE('btnx') , kThemeSoundButtonRelease = FOUR_CHAR_CODE('btnr') , kThemeSoundDefaultButtonPress = FOUR_CHAR_CODE('dbtp') ,
  kThemeSoundDefaultButtonEnter = FOUR_CHAR_CODE('dbte') , kThemeSoundDefaultButtonExit = FOUR_CHAR_CODE('dbtx') , kThemeSoundDefaultButtonRelease = FOUR_CHAR_CODE('dbtr') , kThemeSoundCancelButtonPress = FOUR_CHAR_CODE('cbtp') ,
  kThemeSoundCancelButtonEnter = FOUR_CHAR_CODE('cbte') , kThemeSoundCancelButtonExit = FOUR_CHAR_CODE('cbtx') , kThemeSoundCancelButtonRelease = FOUR_CHAR_CODE('cbtr') , kThemeSoundCheckboxPress = FOUR_CHAR_CODE('chkp') ,
  kThemeSoundCheckboxEnter = FOUR_CHAR_CODE('chke') , kThemeSoundCheckboxExit = FOUR_CHAR_CODE('chkx') , kThemeSoundCheckboxRelease = FOUR_CHAR_CODE('chkr') , kThemeSoundRadioPress = FOUR_CHAR_CODE('radp') ,
  kThemeSoundRadioEnter = FOUR_CHAR_CODE('rade') , kThemeSoundRadioExit = FOUR_CHAR_CODE('radx') , kThemeSoundRadioRelease = FOUR_CHAR_CODE('radr') , kThemeSoundScrollArrowPress = FOUR_CHAR_CODE('sbap') ,
  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') , kThemeSoundSliderTrackPress = FOUR_CHAR_CODE('sltp') , kThemeSoundBalloonOpen = FOUR_CHAR_CODE('blno') ,
  kThemeSoundBalloonClose = FOUR_CHAR_CODE('blnc') , kThemeSoundBevelPress = FOUR_CHAR_CODE('bevp') , kThemeSoundBevelEnter = FOUR_CHAR_CODE('beve') , kThemeSoundBevelExit = FOUR_CHAR_CODE('bevx') ,
  kThemeSoundBevelRelease = FOUR_CHAR_CODE('bevr') , kThemeSoundLittleArrowUpPress = FOUR_CHAR_CODE('laup') , 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') ,
  kThemeSoundPopupEnter = FOUR_CHAR_CODE('pope') , kThemeSoundPopupExit = FOUR_CHAR_CODE('popx') , kThemeSoundPopupRelease = FOUR_CHAR_CODE('popr') , kThemeSoundDisclosurePress = FOUR_CHAR_CODE('dscp') ,
  kThemeSoundDisclosureEnter = FOUR_CHAR_CODE('dsce') , kThemeSoundDisclosureExit = FOUR_CHAR_CODE('dscx') , kThemeSoundDisclosureRelease = FOUR_CHAR_CODE('dscr') , kThemeSoundTabPressed = FOUR_CHAR_CODE('tabp') ,
  kThemeSoundTabEnter = FOUR_CHAR_CODE('tabe') , kThemeSoundTabExit = FOUR_CHAR_CODE('tabx') , kThemeSoundTabRelease = FOUR_CHAR_CODE('tabr') , kThemeSoundDragTargetHilite = FOUR_CHAR_CODE('dthi') ,
  kThemeSoundDragTargetUnhilite = FOUR_CHAR_CODE('dtuh') , kThemeSoundDragTargetDrop = FOUR_CHAR_CODE('dtdr') , kThemeSoundEmptyTrash = FOUR_CHAR_CODE('ftrs') , 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')
}
 
enum  { kThemePopupTabNormalPosition = 0 , kThemePopupTabCenterOnWindow = 1 , kThemePopupTabCenterOnOffset = 2 }
 
enum  {
  kThemeMetricScrollBarWidth = 0 , kThemeMetricSmallScrollBarWidth = 1 , kThemeMetricCheckBoxHeight = 2 , kThemeMetricRadioButtonHeight = 3 ,
  kThemeMetricEditTextWhitespace = 4 , kThemeMetricEditTextFrameOutset = 5 , kThemeMetricListBoxFrameOutset = 6 , kThemeMetricFocusRectOutset = 7 ,
  kThemeMetricImageWellThickness = 8 , kThemeMetricScrollBarOverlap = 9 , kThemeMetricLargeTabHeight = 10 , kThemeMetricLargeTabCapsWidth = 11 ,
  kThemeMetricTabFrameOverlap = 12 , kThemeMetricTabIndentOrStyle = 13 , kThemeMetricTabOverlap = 14 , kThemeMetricSmallTabHeight = 15 ,
  kThemeMetricSmallTabCapsWidth = 16 , kThemeMetricDisclosureButtonHeight = 17 , kThemeMetricRoundButtonSize = 18 , kThemeMetricPushButtonHeight = 19 ,
  kThemeMetricListHeaderHeight = 20 , kThemeMetricSmallCheckBoxHeight = 21 , kThemeMetricDisclosureButtonWidth = 22 , kThemeMetricSmallDisclosureButtonHeight = 23 ,
  kThemeMetricSmallDisclosureButtonWidth = 24 , kThemeMetricDisclosureTriangleHeight = 25 , kThemeMetricDisclosureTriangleWidth = 26 , kThemeMetricLittleArrowsHeight = 27 ,
  kThemeMetricLittleArrowsWidth = 28 , kThemeMetricPaneSplitterHeight = 29 , kThemeMetricPopupButtonHeight = 30 , kThemeMetricSmallPopupButtonHeight = 31 ,
  kThemeMetricLargeProgressBarThickness = 32 , kThemeMetricPullDownHeight = 33 , kThemeMetricSmallPullDownHeight = 34 , kThemeMetricSmallPushButtonHeight = 35 ,
  kThemeMetricSmallRadioButtonHeight = 36 , kThemeMetricRelevanceIndicatorHeight = 37 , kThemeMetricResizeControlHeight = 38 , kThemeMetricSmallResizeControlHeight = 39 ,
  kThemeMetricLargeRoundButtonSize = 40 , kThemeMetricHSliderHeight = 41 , kThemeMetricHSliderTickHeight = 42 , kThemeMetricSmallHSliderHeight = 43 ,
  kThemeMetricSmallHSliderTickHeight = 44 , kThemeMetricVSliderWidth = 45 , kThemeMetricVSliderTickWidth = 46 , kThemeMetricSmallVSliderWidth = 47 ,
  kThemeMetricSmallVSliderTickWidth = 48 , kThemeMetricTitleBarControlsHeight = 49 , kThemeMetricCheckBoxWidth = 50 , kThemeMetricSmallCheckBoxWidth = 51 ,
  kThemeMetricRadioButtonWidth = 52 , kThemeMetricSmallRadioButtonWidth = 53 , kThemeMetricSmallHSliderMinThumbWidth = 54 , kThemeMetricSmallVSliderMinThumbHeight = 55 ,
  kThemeMetricSmallHSliderTickOffset = 56 , kThemeMetricSmallVSliderTickOffset = 57 , kThemeMetricNormalProgressBarThickness = 58 , kThemeMetricProgressBarShadowOutset = 59 ,
  kThemeMetricSmallProgressBarShadowOutset = 60 , kThemeMetricPrimaryGroupBoxContentInset = 61 , kThemeMetricSecondaryGroupBoxContentInset = 62 , kThemeMetricMenuMarkColumnWidth = 63 ,
  kThemeMetricMenuExcludedMarkColumnWidth = 64 , kThemeMetricMenuMarkIndent = 65 , kThemeMetricMenuTextLeadingEdgeMargin = 66 , kThemeMetricMenuTextTrailingEdgeMargin = 67 ,
  kThemeMetricMenuIndentWidth = 68 , kThemeMetricMenuIconTrailingEdgeMargin = 69
}
 
enum  { uppThemeTabTitleDrawProcInfo = 0x00036AC0 }
 
enum  { uppThemeEraseProcInfo = 0x00001BC0 }
 
enum  { uppThemeButtonDrawProcInfo = 0x0001BEC0 }
 
enum  { uppWindowTitleDrawingProcInfo = 0x000036C0 }
 
enum  { uppThemeIteratorProcInfo = 0x00003ED0 }
 
enum  { uppMenuTitleDrawingProcInfo = 0x000036C0 }
 
enum  { uppMenuItemDrawingProcInfo = 0x000036C0 }
 
enum  {
  appearanceBadBrushIndexErr = themeInvalidBrushErr , appearanceProcessRegisteredErr = themeProcessRegisteredErr , appearanceProcessNotRegisteredErr = themeProcessNotRegisteredErr , appearanceBadTextColorIndexErr = themeBadTextColorErr ,
  appearanceThemeHasNoAccents = themeHasNoAccentsErr , appearanceBadCursorIndexErr = themeBadCursorIndexErr
}
 
enum  {
  kThemeActiveDialogBackgroundBrush = kThemeBrushDialogBackgroundActive , kThemeInactiveDialogBackgroundBrush = kThemeBrushDialogBackgroundInactive , kThemeActiveAlertBackgroundBrush = kThemeBrushAlertBackgroundActive , kThemeInactiveAlertBackgroundBrush = kThemeBrushAlertBackgroundInactive ,
  kThemeActiveModelessDialogBackgroundBrush , kThemeInactiveModelessDialogBackgroundBrush , kThemeActiveUtilityWindowBackgroundBrush , kThemeInactiveUtilityWindowBackgroundBrush ,
  kThemeListViewSortColumnBackgroundBrush , kThemeListViewBackgroundBrush = kThemeBrushListViewBackground , kThemeIconLabelBackgroundBrush = kThemeBrushIconLabelBackground , kThemeListViewSeparatorBrush = kThemeBrushListViewSeparator ,
  kThemeChasingArrowsBrush = kThemeBrushChasingArrows , kThemeDragHiliteBrush = kThemeBrushDragHilite , kThemeDocumentWindowBackgroundBrush = kThemeBrushDocumentWindowBackground , kThemeFinderWindowBackgroundBrush = kThemeBrushFinderWindowBackground
}
 
enum  {
  kThemeActiveScrollBarDelimiterBrush = kThemeBrushScrollBarDelimiterActive , kThemeInactiveScrollBarDelimiterBrush = kThemeBrushScrollBarDelimiterInactive , kThemeFocusHighlightBrush = kThemeBrushFocusHighlight , kThemeActivePopupArrowBrush = kThemeBrushPopupArrowActive ,
  kThemePressedPopupArrowBrush = kThemeBrushPopupArrowPressed , kThemeInactivePopupArrowBrush = kThemeBrushPopupArrowInactive , kThemeAppleGuideCoachmarkBrush = kThemeBrushAppleGuideCoachmark
}
 
enum  {
  kThemeActiveDialogTextColor = kThemeTextColorDialogActive , kThemeInactiveDialogTextColor = kThemeTextColorDialogInactive , kThemeActiveAlertTextColor = kThemeTextColorAlertActive , kThemeInactiveAlertTextColor = kThemeTextColorAlertInactive ,
  kThemeActiveModelessDialogTextColor = kThemeTextColorModelessDialogActive , kThemeInactiveModelessDialogTextColor = kThemeTextColorModelessDialogInactive , kThemeActiveWindowHeaderTextColor = kThemeTextColorWindowHeaderActive , kThemeInactiveWindowHeaderTextColor = kThemeTextColorWindowHeaderInactive ,
  kThemeActivePlacardTextColor = kThemeTextColorPlacardActive , kThemeInactivePlacardTextColor = kThemeTextColorPlacardInactive , kThemePressedPlacardTextColor = kThemeTextColorPlacardPressed , kThemeActivePushButtonTextColor = kThemeTextColorPushButtonActive ,
  kThemeInactivePushButtonTextColor = kThemeTextColorPushButtonInactive , kThemePressedPushButtonTextColor = kThemeTextColorPushButtonPressed , kThemeActiveBevelButtonTextColor = kThemeTextColorBevelButtonActive , kThemeInactiveBevelButtonTextColor = kThemeTextColorBevelButtonInactive ,
  kThemePressedBevelButtonTextColor = kThemeTextColorBevelButtonPressed , kThemeActivePopupButtonTextColor = kThemeTextColorPopupButtonActive , kThemeInactivePopupButtonTextColor = kThemeTextColorPopupButtonInactive , kThemePressedPopupButtonTextColor = kThemeTextColorPopupButtonPressed ,
  kThemeIconLabelTextColor = kThemeTextColorIconLabel , kThemeListViewTextColor = kThemeTextColorListView
}
 
enum  {
  kThemeActiveDocumentWindowTitleTextColor , kThemeInactiveDocumentWindowTitleTextColor , kThemeActiveMovableModalWindowTitleTextColor , kThemeInactiveMovableModalWindowTitleTextColor ,
  kThemeActiveUtilityWindowTitleTextColor , kThemeInactiveUtilityWindowTitleTextColor , kThemeActivePopupWindowTitleColor = kThemeTextColorPopupWindowTitleActive , kThemeInactivePopupWindowTitleColor = kThemeTextColorPopupWindowTitleInactive ,
  kThemeActiveRootMenuTextColor = kThemeTextColorRootMenuActive , kThemeSelectedRootMenuTextColor = kThemeTextColorRootMenuSelected , kThemeDisabledRootMenuTextColor = kThemeTextColorRootMenuDisabled , kThemeActiveMenuItemTextColor = kThemeTextColorMenuItemActive ,
  kThemeSelectedMenuItemTextColor = kThemeTextColorMenuItemSelected , kThemeDisabledMenuItemTextColor = kThemeTextColorMenuItemDisabled , kThemeActivePopupLabelTextColor = kThemeTextColorPopupLabelActive , kThemeInactivePopupLabelTextColor = kThemeTextColorPopupLabelInactive
}
 
enum  { kAEThemeSwitch = kAEAppearanceChanged }
 
enum  {
  kThemeNoAdornment = kThemeAdornmentNone , kThemeDefaultAdornment = kThemeAdornmentDefault , kThemeFocusAdornment = kThemeAdornmentFocus , kThemeRightToLeftAdornment = kThemeAdornmentRightToLeft ,
  kThemeDrawIndicatorOnly = kThemeAdornmentDrawIndicatorOnly
}
 
enum  { kThemeBrushPassiveAreaFill = kThemeBrushStaticAreaFill }
 
enum  {
  kThemeMetricCheckBoxGlyphHeight = kThemeMetricCheckBoxHeight , kThemeMetricRadioButtonGlyphHeight = kThemeMetricRadioButtonHeight , kThemeMetricDisclosureButtonSize = kThemeMetricDisclosureButtonHeight , kThemeMetricBestListHeaderHeight = kThemeMetricListHeaderHeight ,
  kThemeMetricSmallProgressBarThickness , kThemeMetricProgressBarThickness
}
 
enum  { kThemeScrollBar = kThemeMediumScrollBar , kThemeSlider = kThemeMediumSlider , kThemeProgressBar = kThemeMediumProgressBar , kThemeIndeterminateBar = kThemeMediumIndeterminateBar }
 

Functions

typedef CALLBACK_API (void, ThemeTabTitleDrawProcPtr)(const Rect *bounds
 
typedef CALLBACK_API (void, ThemeEraseProcPtr)(const Rect *bounds
 
typedef CALLBACK_API (void, ThemeButtonDrawProcPtr)(const Rect *bounds
 
typedef CALLBACK_API (void, WindowTitleDrawingProcPtr)(const Rect *bounds
 
typedef CALLBACK_API (Boolean, ThemeIteratorProcPtr)(ConstStr255Param inFileName
 
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
 
ThemeTabTitleDrawUPP NewThemeTabTitleDrawUPP (ThemeTabTitleDrawProcPtr userRoutine)
 
ThemeEraseUPP NewThemeEraseUPP (ThemeEraseProcPtr userRoutine)
 
ThemeButtonDrawUPP NewThemeButtonDrawUPP (ThemeButtonDrawProcPtr userRoutine)
 
WindowTitleDrawingUPP NewWindowTitleDrawingUPP (WindowTitleDrawingProcPtr userRoutine)
 
ThemeIteratorUPP NewThemeIteratorUPP (ThemeIteratorProcPtr userRoutine)
 
void DisposeThemeTabTitleDrawUPP (ThemeTabTitleDrawUPP userUPP)
 
void DisposeThemeEraseUPP (ThemeEraseUPP userUPP)
 
void DisposeThemeButtonDrawUPP (ThemeButtonDrawUPP userUPP)
 
void DisposeWindowTitleDrawingUPP (WindowTitleDrawingUPP userUPP)
 
void DisposeThemeIteratorUPP (ThemeIteratorUPP userUPP)
 
void InvokeThemeTabTitleDrawUPP (const Rect *bounds, ThemeTabStyle style, ThemeTabDirection direction, SInt16 depth, Boolean isColorDev, UInt32 userData, ThemeTabTitleDrawUPP userUPP)
 
void InvokeThemeEraseUPP (const Rect *bounds, UInt32 eraseData, SInt16 depth, Boolean isColorDev, ThemeEraseUPP userUPP)
 
void InvokeThemeButtonDrawUPP (const Rect *bounds, ThemeButtonKind kind, const ThemeButtonDrawInfo *info, UInt32 userData, SInt16 depth, Boolean isColorDev, ThemeButtonDrawUPP userUPP)
 
void InvokeWindowTitleDrawingUPP (const Rect *bounds, SInt16 depth, Boolean colorDevice, UInt32 userData, WindowTitleDrawingUPP userUPP)
 
Boolean InvokeThemeIteratorUPP (ConstStr255Param inFileName, SInt16 resID, Collection inThemeSettings, void *inUserData, ThemeIteratorUPP userUPP)
 
typedef CALLBACK_API (void, MenuTitleDrawingProcPtr)(const Rect *inBounds
 
typedef CALLBACK_API (void, MenuItemDrawingProcPtr)(const Rect *inBounds
 
typedef STACK_UPP_TYPE (MenuTitleDrawingProcPtr) MenuTitleDrawingUPP
 
typedef STACK_UPP_TYPE (MenuItemDrawingProcPtr) MenuItemDrawingUPP
 
MenuTitleDrawingUPP NewMenuTitleDrawingUPP (MenuTitleDrawingProcPtr userRoutine)
 
MenuItemDrawingUPP NewMenuItemDrawingUPP (MenuItemDrawingProcPtr userRoutine)
 
void DisposeMenuTitleDrawingUPP (MenuTitleDrawingUPP userUPP)
 
void DisposeMenuItemDrawingUPP (MenuItemDrawingUPP userUPP)
 
void InvokeMenuTitleDrawingUPP (const Rect *inBounds, SInt16 inDepth, Boolean inIsColorDevice, SInt32 inUserData, MenuTitleDrawingUPP userUPP)
 
void InvokeMenuItemDrawingUPP (const Rect *inBounds, SInt16 inDepth, Boolean inIsColorDevice, SInt32 inUserData, MenuItemDrawingUPP userUPP)
 
OSStatus RegisterAppearanceClient (void)
 
OSStatus UnregisterAppearanceClient (void)
 
Boolean IsAppearanceClient (const ProcessSerialNumber *process)
 
OSStatus SetThemePen (ThemeBrush inBrush, SInt16 inDepth, Boolean inIsColorDevice)
 
OSStatus SetThemeBackground (ThemeBrush inBrush, SInt16 inDepth, Boolean inIsColorDevice)
 
OSStatus SetThemeTextColor (ThemeTextColor inColor, SInt16 inDepth, Boolean inIsColorDevice)
 
OSStatus SetThemeWindowBackground (WindowRef inWindow, ThemeBrush inBrush, Boolean inUpdate)
 
OSStatus DrawThemeWindowHeader (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeWindowListViewHeader (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemePlacard (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeEditTextFrame (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeListBoxFrame (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeFocusRect (const Rect *inRect, Boolean inHasFocus)
 
OSStatus DrawThemePrimaryGroup (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeSecondaryGroup (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeSeparator (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeModelessDialogFrame (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeGenericWell (const Rect *inRect, ThemeDrawState inState, Boolean inFillCenter)
 
OSStatus DrawThemeFocusRegion (RgnHandle inRegion, Boolean inHasFocus)
 
Boolean IsThemeInColor (SInt16 inDepth, Boolean inIsColorDevice)
 
OSStatus GetThemeAccentColors (CTabHandle *outColors)
 
OSStatus DrawThemeMenuBarBackground (const Rect *inBounds, ThemeMenuBarState inState, UInt32 inAttributes)
 
OSStatus DrawThemeMenuTitle (const Rect *inMenuBarRect, const Rect *inTitleRect, ThemeMenuState inState, UInt32 inAttributes, MenuTitleDrawingUPP inTitleProc, UInt32 inTitleData)
 
OSStatus GetThemeMenuBarHeight (SInt16 *outHeight)
 
OSStatus DrawThemeMenuBackground (const Rect *inMenuRect, ThemeMenuType inMenuType)
 
OSStatus GetThemeMenuBackgroundRegion (const Rect *inMenuRect, ThemeMenuType menuType, RgnHandle region)
 
OSStatus DrawThemeMenuItem (const Rect *inMenuRect, const Rect *inItemRect, SInt16 inVirtualMenuTop, SInt16 inVirtualMenuBottom, ThemeMenuState inState, ThemeMenuItemType inItemType, MenuItemDrawingUPP inDrawProc, UInt32 inUserData)
 
OSStatus DrawThemeMenuSeparator (const Rect *inItemRect)
 
OSStatus GetThemeMenuSeparatorHeight (SInt16 *outHeight)
 
OSStatus GetThemeMenuItemExtra (ThemeMenuItemType inItemType, SInt16 *outHeight, SInt16 *outWidth)
 
OSStatus GetThemeMenuTitleExtra (SInt16 *outWidth, Boolean inIsSquished)
 
OSStatus GetTheme (Collection ioCollection)
 
OSStatus SetTheme (Collection ioCollection)
 
OSStatus IterateThemes (ThemeIteratorUPP inProc, void *inUserData)
 
OSStatus DrawThemeTabPane (const Rect *inRect, ThemeDrawState inState)
 
OSStatus DrawThemeTab (const Rect *inRect, ThemeTabStyle inStyle, ThemeTabDirection inDirection, ThemeTabTitleDrawUPP labelProc, UInt32 userData)
 
OSStatus GetThemeTabRegion (const Rect *inRect, ThemeTabStyle inStyle, ThemeTabDirection inDirection, RgnHandle ioRgn)
 
OSStatus SetThemeCursor (ThemeCursor inCursor)
 
OSStatus SetAnimatedThemeCursor (ThemeCursor inCursor, UInt32 inAnimationStep)
 
OSStatus GetThemeScrollBarThumbStyle (ThemeScrollBarThumbStyle *outStyle)
 
OSStatus GetThemeScrollBarArrowStyle (ThemeScrollBarArrowStyle *outStyle)
 
OSStatus GetThemeCheckBoxStyle (ThemeCheckBoxStyle *outStyle)
 
OSStatus UseThemeFont (ThemeFontID inFontID, ScriptCode inScript)
 
OSStatus GetThemeFont (ThemeFontID inFontID, ScriptCode inScript, Str255 outFontName, SInt16 *outFontSize, Style *outStyle)
 
OSStatus DrawThemeTextBox (CFStringRef inString, ThemeFontID inFontID, ThemeDrawState inState, Boolean inWrapToWidth, const Rect *inBoundingBox, SInt16 inJust, void *inContext)
 
OSStatus TruncateThemeText (CFMutableStringRef inString, ThemeFontID inFontID, ThemeDrawState inState, SInt16 inPixelWidthLimit, TruncCode inTruncWhere, Boolean *outTruncated)
 
OSStatus GetThemeTextDimensions (CFStringRef inString, ThemeFontID inFontID, ThemeDrawState inState, Boolean inWrapToWidth, Point *ioBounds, SInt16 *outBaseline)
 
OSStatus GetThemeTextShadowOutset (ThemeFontID inFontID, ThemeDrawState inState, Rect *outOutset)
 
OSStatus DrawThemeTrack (const ThemeTrackDrawInfo *drawInfo, RgnHandle rgnGhost, ThemeEraseUPP eraseProc, UInt32 eraseData)
 
Boolean HitTestThemeTrack (const ThemeTrackDrawInfo *drawInfo, Point mousePoint, ControlPartCode *partHit)
 
OSStatus GetThemeTrackBounds (const ThemeTrackDrawInfo *drawInfo, Rect *bounds)
 
OSStatus GetThemeTrackThumbRgn (const ThemeTrackDrawInfo *drawInfo, RgnHandle thumbRgn)
 
OSStatus GetThemeTrackDragRect (const ThemeTrackDrawInfo *drawInfo, Rect *dragRect)
 
OSStatus DrawThemeTrackTickMarks (const ThemeTrackDrawInfo *drawInfo, ItemCount numTicks, ThemeEraseUPP eraseProc, UInt32 eraseData)
 
OSStatus GetThemeTrackThumbPositionFromOffset (const ThemeTrackDrawInfo *drawInfo, Point thumbOffset, SInt32 *relativePosition)
 
OSStatus GetThemeTrackThumbPositionFromRegion (const ThemeTrackDrawInfo *drawInfo, RgnHandle thumbRgn, SInt32 *relativePosition)
 
OSStatus GetThemeTrackLiveValue (const ThemeTrackDrawInfo *drawInfo, SInt32 relativePosition, SInt32 *value)
 
OSStatus DrawThemeScrollBarArrows (const Rect *bounds, ThemeTrackEnableState enableState, ThemeTrackPressState pressState, Boolean isHoriz, Rect *trackBounds)
 
OSStatus GetThemeScrollBarTrackRect (const Rect *bounds, ThemeTrackEnableState enableState, ThemeTrackPressState pressState, Boolean isHoriz, Rect *trackBounds)
 
Boolean HitTestThemeScrollBarArrows (const Rect *scrollBarBounds, ThemeTrackEnableState enableState, ThemeTrackPressState pressState, Boolean isHoriz, Point ptHit, Rect *trackBounds, ControlPartCode *partcode)
 
OSStatus GetThemeWindowRegion (ThemeWindowType flavor, const Rect *contRect, ThemeDrawState state, const ThemeWindowMetrics *metrics, ThemeWindowAttributes attributes, WindowRegionCode winRegion, RgnHandle rgn)
 
OSStatus DrawThemeWindowFrame (ThemeWindowType flavor, const Rect *contRect, ThemeDrawState state, const ThemeWindowMetrics *metrics, ThemeWindowAttributes attributes, WindowTitleDrawingUPP titleProc, UInt32 titleData)
 
OSStatus DrawThemeTitleBarWidget (ThemeWindowType flavor, const Rect *contRect, ThemeDrawState state, const ThemeWindowMetrics *metrics, ThemeWindowAttributes attributes, ThemeTitleBarWidget widget)
 
Boolean GetThemeWindowRegionHit (ThemeWindowType flavor, const Rect *inContRect, ThemeDrawState state, const ThemeWindowMetrics *metrics, ThemeWindowAttributes inAttributes, Point inPoint, WindowRegionCode *outRegionHit)
 
OSStatus DrawThemeScrollBarDelimiters (ThemeWindowType flavor, const Rect *inContRect, ThemeDrawState state, ThemeWindowAttributes attributes)
 
OSStatus DrawThemeButton (const Rect *inBounds, ThemeButtonKind inKind, const ThemeButtonDrawInfo *inNewInfo, const ThemeButtonDrawInfo *inPrevInfo, ThemeEraseUPP inEraseProc, ThemeButtonDrawUPP inLabelProc, UInt32 inUserData)
 
OSStatus GetThemeButtonRegion (const Rect *inBounds, ThemeButtonKind inKind, const ThemeButtonDrawInfo *inNewInfo, RgnHandle outRegion)
 
OSStatus GetThemeButtonContentBounds (const Rect *inBounds, ThemeButtonKind inKind, const ThemeButtonDrawInfo *inDrawInfo, Rect *outBounds)
 
OSStatus GetThemeButtonBackgroundBounds (const Rect *inBounds, ThemeButtonKind inKind, const ThemeButtonDrawInfo *inDrawInfo, Rect *outBounds)
 
OSStatus PlayThemeSound (ThemeSoundKind kind)
 
OSStatus BeginThemeDragSound (ThemeDragSoundKind kind)
 
OSStatus EndThemeDragSound (void)
 
OSStatus DrawThemeTickMark (const Rect *bounds, ThemeDrawState state)
 
OSStatus DrawThemeChasingArrows (const Rect *bounds, UInt32 index, ThemeDrawState state, ThemeEraseUPP eraseProc, UInt32 eraseData)
 
OSStatus DrawThemePopupArrow (const Rect *bounds, ThemeArrowOrientation orientation, ThemePopupArrowSize size, ThemeDrawState state, ThemeEraseUPP eraseProc, UInt32 eraseData)
 
OSStatus DrawThemeStandaloneGrowBox (Point origin, ThemeGrowDirection growDirection, Boolean isSmall, ThemeDrawState state)
 
OSStatus DrawThemeStandaloneNoGrowBox (Point origin, ThemeGrowDirection growDirection, Boolean isSmall, ThemeDrawState state)
 
OSStatus GetThemeStandaloneGrowBoxBounds (Point origin, ThemeGrowDirection growDirection, Boolean isSmall, Rect *bounds)
 
OSStatus NormalizeThemeDrawingState (void)
 
OSStatus GetThemeDrawingState (ThemeDrawingState *outState)
 
OSStatus SetThemeDrawingState (ThemeDrawingState inState, Boolean inDisposeNow)
 
OSStatus DisposeThemeDrawingState (ThemeDrawingState inState)
 
OSStatus ApplyThemeBackground (ThemeBackgroundKind inKind, const Rect *bounds, ThemeDrawState inState, SInt16 inDepth, Boolean inColorDev)
 
OSStatus SetThemeTextColorForWindow (WindowRef window, Boolean isActive, SInt16 depth, Boolean isColorDev)
 
Boolean IsValidAppearanceFileType (OSType fileType)
 
OSStatus GetThemeBrushAsColor (ThemeBrush inBrush, SInt16 inDepth, Boolean inColorDev, RGBColor *outColor)
 
OSStatus GetThemeTextColor (ThemeTextColor inColor, SInt16 inDepth, Boolean inColorDev, RGBColor *outColor)
 
OSStatus GetThemeMetric (ThemeMetric inMetric, SInt32 *outMetric)
 
OSStatus GetTextAndEncodingFromCFString (CFStringRef inString, BytePtr outText, ByteCount inTextMaxLength, ByteCount *outTextLength, TextEncoding *outEncoding)
 
OSStatus CopyThemeIdentifier (CFStringRef *outIdentifier)
 

Detailed Description

Appearance Manager Interfaces.

Introduced In: Mac OS 9
Avaliable From: Universal Interfaces 3.4.1
Copyright: � 1994-2001 by Apple Computer, Inc., all rights reserved

For bug reports, consult the following page on the World Wide Web:

http://developer.apple.com/bugreporter/

Macro Definition Documentation

◆ CallMenuItemDrawingProc

#define CallMenuItemDrawingProc (   userRoutine,
  inBounds,
  inDepth,
  inIsColorDevice,
  inUserData 
)
Value:
InvokeMenuItemDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, \
userRoutine)
void InvokeMenuItemDrawingUPP(const Rect *inBounds, SInt16 inDepth, Boolean inIsColorDevice, SInt32 inUserData, MenuItemDrawingUPP userUPP)

◆ CallMenuTitleDrawingProc

#define CallMenuTitleDrawingProc (   userRoutine,
  inBounds,
  inDepth,
  inIsColorDevice,
  inUserData 
)
Value:
InvokeMenuTitleDrawingUPP(inBounds, inDepth, inIsColorDevice, inUserData, \
userRoutine)
void InvokeMenuTitleDrawingUPP(const Rect *inBounds, SInt16 inDepth, Boolean inIsColorDevice, SInt32 inUserData, MenuTitleDrawingUPP userUPP)

◆ CallThemeButtonDrawProc

#define CallThemeButtonDrawProc (   userRoutine,
  bounds,
  kind,
  info,
  userData,
  depth,
  isColorDev 
)
Value:
InvokeThemeButtonDrawUPP(bounds, kind, info, userData, depth, isColorDev, \
userRoutine)
void InvokeThemeButtonDrawUPP(const Rect *bounds, ThemeButtonKind kind, const ThemeButtonDrawInfo *info, UInt32 userData, SInt16 depth, Boolean isColorDev, ThemeButtonDrawUPP userUPP)

◆ CallThemeIteratorProc

#define CallThemeIteratorProc (   userRoutine,
  inFileName,
  resID,
  inThemeSettings,
  inUserData 
)
Value:
InvokeThemeIteratorUPP(inFileName, resID, inThemeSettings, inUserData, \
userRoutine)
Boolean InvokeThemeIteratorUPP(ConstStr255Param inFileName, SInt16 resID, Collection inThemeSettings, void *inUserData, ThemeIteratorUPP userUPP)

◆ CallThemeTabTitleDrawProc

#define CallThemeTabTitleDrawProc (   userRoutine,
  bounds,
  style,
  direction,
  depth,
  isColorDev,
  userData 
)
Value:
InvokeThemeTabTitleDrawUPP(bounds, style, direction, depth, isColorDev, \
userData, userRoutine)
void InvokeThemeTabTitleDrawUPP(const Rect *bounds, ThemeTabStyle style, ThemeTabDirection direction, SInt16 depth, Boolean isColorDev, UInt32 userData, ThemeTabTitleDrawUPP userUPP)

◆ InvokeMenuItemDrawingUPP

#define InvokeMenuItemDrawingUPP (   inBounds,
  inDepth,
  inIsColorDevice,
  inUserData,
  userUPP 
)
Value:
CALL_FOUR_PARAMETER_UPP((userUPP), uppMenuItemDrawingProcInfo, (inBounds), \
(inDepth), (inIsColorDevice), (inUserData))

◆ InvokeMenuTitleDrawingUPP

#define InvokeMenuTitleDrawingUPP (   inBounds,
  inDepth,
  inIsColorDevice,
  inUserData,
  userUPP 
)
Value:
CALL_FOUR_PARAMETER_UPP((userUPP), uppMenuTitleDrawingProcInfo, (inBounds), \
(inDepth), (inIsColorDevice), (inUserData))

◆ InvokeThemeButtonDrawUPP

#define InvokeThemeButtonDrawUPP (   bounds,
  kind,
  info,
  userData,
  depth,
  isColorDev,
  userUPP 
)
Value:
CALL_SIX_PARAMETER_UPP((userUPP), uppThemeButtonDrawProcInfo, (bounds), \
(kind), (info), (userData), (depth), (isColorDev))

◆ InvokeThemeEraseUPP

#define InvokeThemeEraseUPP (   bounds,
  eraseData,
  depth,
  isColorDev,
  userUPP 
)
Value:
CALL_FOUR_PARAMETER_UPP((userUPP), uppThemeEraseProcInfo, (bounds), \
(eraseData), (depth), (isColorDev))

◆ InvokeThemeIteratorUPP

#define InvokeThemeIteratorUPP (   inFileName,
  resID,
  inThemeSettings,
  inUserData,
  userUPP 
)
Value:
(Boolean) CALL_FOUR_PARAMETER_UPP((userUPP), uppThemeIteratorProcInfo, \
(inFileName), (resID), (inThemeSettings), \
(inUserData))
unsigned char Boolean
Definition: MacTypes.h:318

◆ InvokeThemeTabTitleDrawUPP

#define InvokeThemeTabTitleDrawUPP (   bounds,
  style,
  direction,
  depth,
  isColorDev,
  userData,
  userUPP 
)
Value:
CALL_SIX_PARAMETER_UPP((userUPP), uppThemeTabTitleDrawProcInfo, (bounds), \
(style), (direction), (depth), (isColorDev), \
(userData))

◆ InvokeWindowTitleDrawingUPP

#define InvokeWindowTitleDrawingUPP (   bounds,
  depth,
  colorDevice,
  userData,
  userUPP 
)
Value:
CALL_FOUR_PARAMETER_UPP((userUPP), uppWindowTitleDrawingProcInfo, (bounds), \
(depth), (colorDevice), (userData))

◆ NewMenuItemDrawingUPP

#define NewMenuItemDrawingUPP (   userRoutine)
Value:
(MenuItemDrawingUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppMenuItemDrawingProcInfo, \
GetCurrentArchitecture())
UniversalProcPtr NewRoutineDescriptor(ProcPtr theProc, ProcInfoType theProcInfo, ISAType theISA)

◆ NewMenuTitleDrawingUPP

#define NewMenuTitleDrawingUPP (   userRoutine)
Value:
(MenuTitleDrawingUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), \
uppMenuTitleDrawingProcInfo, \
GetCurrentArchitecture())

◆ NewThemeButtonDrawUPP

#define NewThemeButtonDrawUPP (   userRoutine)
Value:
(ThemeButtonDrawUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppThemeButtonDrawProcInfo, \
GetCurrentArchitecture())

◆ NewThemeEraseUPP

#define NewThemeEraseUPP (   userRoutine)
Value:
(ThemeEraseUPP) NewRoutineDescriptor( \
(ProcPtr)(userRoutine), uppThemeEraseProcInfo, GetCurrentArchitecture())

◆ NewThemeIteratorUPP

#define NewThemeIteratorUPP (   userRoutine)
Value:
(ThemeIteratorUPP) \
NewRoutineDescriptor((ProcPtr)(userRoutine), uppThemeIteratorProcInfo, \
GetCurrentArchitecture())

◆ NewThemeTabTitleDrawUPP

#define NewThemeTabTitleDrawUPP (   userRoutine)
Value:
(ThemeTabTitleDrawUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), \
uppThemeTabTitleDrawProcInfo, \
GetCurrentArchitecture())

◆ NewWindowTitleDrawingUPP

#define NewWindowTitleDrawingUPP (   userRoutine)
Value:
(WindowTitleDrawingUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), \
uppWindowTitleDrawingProcInfo, \
GetCurrentArchitecture())

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Summary: A ThemeFontID value is a virtual font ID which can be passed to one of the Appearance Manager's text-related routines. Within those routines, the ThemeFontID is mapped into the appropriate real font (or fonts), size, and style based on the system appearance (Platinum on Mac OS 9, Aqua on Mac OS X), the string to be rendered (if any), the language/ script that the app is running in, and possibly other factors. The ThemeFontIDs allow you to get the correct text appearance for the platform your app is currently running on.

Enumerator
kThemeSystemFont 

The font used to draw most interface elements. If you can't find a more appropriate font from the list below, you should use this one. This font is suitable for drawing titles on most custom widgets/buttons, as well as most static text in dialogs and windows.

kThemeSmallSystemFont 

The font used to draw interface elements when space is at a premium. It draws a slightly smaller font compared to kThemeSystemFont.

kThemeSmallEmphasizedSystemFont 

Identical to kThemeSmallSystemFont, except it draws bolded (or otherwise emphasized in some fashion appropriate to your application's language/script).

kThemeViewsFont 

The font used to draw file and folder names in Finder windows or other browsable lists.

kThemeEmphasizedSystemFont 

Identical to kThemeSystemFont, except it draws bolded (or otherwise emphasized in some fashion appropriate to your application's language/script). Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeApplicationFont 

An analog to the Script Manager's notion of the Application Font. This font is a suitable default choice for your application's document-style text editing areas. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeLabelFont 

Generally smaller than kThemeSmallSystemFont, this font is appropriate for drawing text labels next to image content that reinforces the text's meaning (such as on a bevel button). Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeMenuTitleFont 

The font used to draw menu titles in the menu bar. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeMenuItemFont 

The font used to draw menu items in the menus. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeMenuItemMarkFont 

The font used to draw menu item marks in the menus. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeMenuItemCmdKeyFont 

The font used to draw menu item command key equivalents in the menus. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeWindowTitleFont 

The font used to draw text in most window title bars. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemePushButtonFont 

The font used to draw text labels on push buttons. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeUtilityWindowTitleFont 

The font used to draw text in utility window title bars. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeAlertHeaderFont 

The font used to draw the first (and most important) message of an alert window. Only available on Mac OS X or CarbonLib 1.3 or later.

kThemeCurrentPortFont 

Unlike the other ThemeFontIDs, this one doesn't map to a font appropriate to your application's language or script. It maps directly to the font, size, and style of the current Quickdraw port. This allows you to get somewhat customized behavior out of the APIs which take ThemeFontIDs. Note, however, that kThemeCurrentPortFont does not (and will never) support all Quickdraw styles on all platforms; in particular, outline and shadow style are not supported on Mac OS X. Additionally, kThemeCurrentPortFont is not (and will never be) completely unicode savvy; use of kThemeCurrentPortFont may result in errors having to do with the current port's font not being appropriate for rendering or measuring all glyphs in a given unicode string. Because of overhead associated with gathering Quickdraw font information and converting it to the native font format on Mac OS X, use of kThemeCurrentPortFont may slow down your text drawing and measuring significantly compared to other ThemeFontIDs. Instead of using kThemeCurrentPortFont, your application will probably be better served by using one of the other ThemeFontIDs; use kThemeCurrentPortFont only as a last resort. Only available on Mac OS X or CarbonLib 1.3 or later.

◆ anonymous enum

anonymous enum

Discussion: Theme metrics allow you to find out sizes of things in the current environment, such as how wide a scroll bar is, etc.

Enumerator
kThemeMetricMenuMarkColumnWidth 

Width allocated to draw the mark character in a menu. Width allocated for the mark character in a menu item when the menu has kMenuAttrExcludesMarkColumn. Indent into the interior of the mark column at which the mark character is drawn. Whitespace at the leading edge of menu item text. Whitespace at the trailing edge of menu item text. Width per indent level (set by SetMenuItemIndent) of a menu item. Whitespace at the trailing edge of a menu icon (if the item also has text).

Function Documentation

◆ ApplyThemeBackground()

OSStatus ApplyThemeBackground ( ThemeBackgroundKind  inKind,
const Rect bounds,
ThemeDrawState  inState,
SInt16  inDepth,
Boolean  inColorDev 
)

ApplyThemeBackground()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ BeginThemeDragSound()

OSStatus BeginThemeDragSound ( ThemeDragSoundKind  kind)

BeginThemeDragSound()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ CopyThemeIdentifier()

OSStatus CopyThemeIdentifier ( CFStringRef *  outIdentifier)

CopyThemeIdentifier()

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.4 and later
Mac OS X: in version 10.1 and later

◆ DisposeMenuItemDrawingUPP()

void DisposeMenuItemDrawingUPP ( MenuItemDrawingUPP  userUPP)

DisposeMenuItemDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeMenuTitleDrawingUPP()

void DisposeMenuTitleDrawingUPP ( MenuTitleDrawingUPP  userUPP)

DisposeMenuTitleDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeThemeButtonDrawUPP()

void DisposeThemeButtonDrawUPP ( ThemeButtonDrawUPP  userUPP)

DisposeThemeButtonDrawUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeThemeDrawingState()

OSStatus DisposeThemeDrawingState ( ThemeDrawingState  inState)

DisposeThemeDrawingState()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeThemeEraseUPP()

void DisposeThemeEraseUPP ( ThemeEraseUPP  userUPP)

DisposeThemeEraseUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeThemeIteratorUPP()

void DisposeThemeIteratorUPP ( ThemeIteratorUPP  userUPP)

DisposeThemeIteratorUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeThemeTabTitleDrawUPP()

void DisposeThemeTabTitleDrawUPP ( ThemeTabTitleDrawUPP  userUPP)

DisposeThemeTabTitleDrawUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DisposeWindowTitleDrawingUPP()

void DisposeWindowTitleDrawingUPP ( WindowTitleDrawingUPP  userUPP)

DisposeWindowTitleDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeButton()

OSStatus DrawThemeButton ( const Rect inBounds,
ThemeButtonKind  inKind,
const ThemeButtonDrawInfo inNewInfo,
const ThemeButtonDrawInfo inPrevInfo,
ThemeEraseUPP  inEraseProc,
ThemeButtonDrawUPP  inLabelProc,
UInt32  inUserData 
)

DrawThemeButton()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeChasingArrows()

OSStatus DrawThemeChasingArrows ( const Rect bounds,
UInt32  index,
ThemeDrawState  state,
ThemeEraseUPP  eraseProc,
UInt32  eraseData 
)

DrawThemeChasingArrows()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeEditTextFrame()

OSStatus DrawThemeEditTextFrame ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeEditTextFrame()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeFocusRect()

OSStatus DrawThemeFocusRect ( const Rect inRect,
Boolean  inHasFocus 
)

DrawThemeFocusRect()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeFocusRegion()

OSStatus DrawThemeFocusRegion ( RgnHandle  inRegion,
Boolean  inHasFocus 
)

DrawThemeFocusRegion()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeGenericWell()

OSStatus DrawThemeGenericWell ( const Rect inRect,
ThemeDrawState  inState,
Boolean  inFillCenter 
)

DrawThemeGenericWell()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeListBoxFrame()

OSStatus DrawThemeListBoxFrame ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeListBoxFrame()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeMenuBackground()

OSStatus DrawThemeMenuBackground ( const Rect inMenuRect,
ThemeMenuType  inMenuType 
)

DrawThemeMenuBackground()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeMenuBarBackground()

OSStatus DrawThemeMenuBarBackground ( const Rect inBounds,
ThemeMenuBarState  inState,
UInt32  inAttributes 
)

DrawThemeMenuBarBackground()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeMenuItem()

OSStatus DrawThemeMenuItem ( const Rect inMenuRect,
const Rect inItemRect,
SInt16  inVirtualMenuTop,
SInt16  inVirtualMenuBottom,
ThemeMenuState  inState,
ThemeMenuItemType  inItemType,
MenuItemDrawingUPP  inDrawProc,
UInt32  inUserData 
)

DrawThemeMenuItem()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeMenuSeparator()

OSStatus DrawThemeMenuSeparator ( const Rect inItemRect)

DrawThemeMenuSeparator()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeMenuTitle()

OSStatus DrawThemeMenuTitle ( const Rect inMenuBarRect,
const Rect inTitleRect,
ThemeMenuState  inState,
UInt32  inAttributes,
MenuTitleDrawingUPP  inTitleProc,
UInt32  inTitleData 
)

DrawThemeMenuTitle()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeModelessDialogFrame()

OSStatus DrawThemeModelessDialogFrame ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeModelessDialogFrame()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemePlacard()

OSStatus DrawThemePlacard ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemePlacard()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemePopupArrow()

OSStatus DrawThemePopupArrow ( const Rect bounds,
ThemeArrowOrientation  orientation,
ThemePopupArrowSize  size,
ThemeDrawState  state,
ThemeEraseUPP  eraseProc,
UInt32  eraseData 
)

DrawThemePopupArrow()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemePrimaryGroup()

OSStatus DrawThemePrimaryGroup ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemePrimaryGroup()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeScrollBarArrows()

OSStatus DrawThemeScrollBarArrows ( const Rect bounds,
ThemeTrackEnableState  enableState,
ThemeTrackPressState  pressState,
Boolean  isHoriz,
Rect trackBounds 
)

DrawThemeScrollBarArrows()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeScrollBarDelimiters()

OSStatus DrawThemeScrollBarDelimiters ( ThemeWindowType  flavor,
const Rect inContRect,
ThemeDrawState  state,
ThemeWindowAttributes  attributes 
)

DrawThemeScrollBarDelimiters()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeSecondaryGroup()

OSStatus DrawThemeSecondaryGroup ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeSecondaryGroup()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeSeparator()

OSStatus DrawThemeSeparator ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeSeparator()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeStandaloneGrowBox()

OSStatus DrawThemeStandaloneGrowBox ( Point  origin,
ThemeGrowDirection  growDirection,
Boolean  isSmall,
ThemeDrawState  state 
)

DrawThemeStandaloneGrowBox()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeStandaloneNoGrowBox()

OSStatus DrawThemeStandaloneNoGrowBox ( Point  origin,
ThemeGrowDirection  growDirection,
Boolean  isSmall,
ThemeDrawState  state 
)

DrawThemeStandaloneNoGrowBox()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTab()

OSStatus DrawThemeTab ( const Rect inRect,
ThemeTabStyle  inStyle,
ThemeTabDirection  inDirection,
ThemeTabTitleDrawUPP  labelProc,
UInt32  userData 
)

DrawThemeTab()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTabPane()

OSStatus DrawThemeTabPane ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeTabPane()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTextBox()

OSStatus DrawThemeTextBox ( CFStringRef  inString,
ThemeFontID  inFontID,
ThemeDrawState  inState,
Boolean  inWrapToWidth,
const Rect inBoundingBox,
SInt16  inJust,
void *  inContext 
)

DrawThemeTextBox()

Summary: Draws text into the area you specify.

Discussion: DrawThemeTextBox allows you to draw theme-savvy (ie. Aqua-savvy on Mac OS X) text. It is unicode savvy (although only partially so under CarbonLib), and allows you to customize certain text rendering characteristics such as the font, wrapping behavior, and justification. The text is drawn into the CGContextRef you provide, or into the current Quickdraw port if no CGContextRef is provided. None of DrawThemeTextBox's parameters imply a color, so you must set up the desired text color separately before calling DrawThemeTextBox. If you provide a CGContextRef, its fill color will be used to draw the text. If you do not provide a CGContextRef, a color based on the current Quickdraw port's foreground color and the grayishTextOr mode (if set) will be used to draw the text.

Parameters:

inString: A CFStringRef containing the unicode characters you wish to render. You MUST NOT pass in a CFStringRef that was allocated with any of the "NoCopy" CFString creation APIs; a string created with a "NoCopy" API has transient storage which is incompatible with DrawThemeTextBox's caches.

inFontID: The ThemeFontID describing the font you'd like to render the text with. See the discussion of ThemeFontIDs elsewhere in this header.

inState: The ThemeDrawState describing the the state of the interface element you are drawing the text for. If, for example, you are drawing text for an inactive window, you would pass kThemeStateInactive. The ThemeDrawState is generally only used to determine the shadow characteristics for the text on Mac OS X. Note that the ThemeDrawState does NOT imply a color. It is NOT used as a mechanism for graying the text. If you wish to draw grayed text, you must set up the desired gray color and apply it to either the current Quickdraw port or the CGContextRef as appropriate.

inWrapToWidth: A Boolean indicating whether you want to draw multiple lines of text wrapped to a bounding box. False indicates that only one line of text should be drawn without any sort of wrapping.

inBoundingBox: The rectangle (in coordinates relative to the current Quickdraw port) describing the area to draw the text within. The first line of text will be top-justified to this rectangle. Wrapping (if desired) will happen at the horizontal extent of this rectangle. Regardless of the amount of text in your CFStringRef, all drawn text will be clipped to this rectangle.

inJust: The horizontal justification you would like for your text. You can use one of the standard justification constants from TextEdit.h.

inContext: The CGContextRef into which you would like to draw the text. On Mac OS X, all text drawing happens in CGContextRefs; if you pass NULL, a transient CGContextRef will be allocated and deallocated for use within the single API call. Relying on the system behavior if transiently createing CGContextRefs may result in performance problems. On Mac OS 9, the CGContextRef parameter is ignored.

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.3 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTickMark()

OSStatus DrawThemeTickMark ( const Rect bounds,
ThemeDrawState  state 
)

DrawThemeTickMark()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTitleBarWidget()

OSStatus DrawThemeTitleBarWidget ( ThemeWindowType  flavor,
const Rect contRect,
ThemeDrawState  state,
const ThemeWindowMetrics metrics,
ThemeWindowAttributes  attributes,
ThemeTitleBarWidget  widget 
)

DrawThemeTitleBarWidget()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTrack()

OSStatus DrawThemeTrack ( const ThemeTrackDrawInfo drawInfo,
RgnHandle  rgnGhost,
ThemeEraseUPP  eraseProc,
UInt32  eraseData 
)

DrawThemeTrack()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeTrackTickMarks()

OSStatus DrawThemeTrackTickMarks ( const ThemeTrackDrawInfo drawInfo,
ItemCount  numTicks,
ThemeEraseUPP  eraseProc,
UInt32  eraseData 
)

DrawThemeTrackTickMarks()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeWindowFrame()

OSStatus DrawThemeWindowFrame ( ThemeWindowType  flavor,
const Rect contRect,
ThemeDrawState  state,
const ThemeWindowMetrics metrics,
ThemeWindowAttributes  attributes,
WindowTitleDrawingUPP  titleProc,
UInt32  titleData 
)

DrawThemeWindowFrame()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeWindowHeader()

OSStatus DrawThemeWindowHeader ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeWindowHeader()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ DrawThemeWindowListViewHeader()

OSStatus DrawThemeWindowListViewHeader ( const Rect inRect,
ThemeDrawState  inState 
)

DrawThemeWindowListViewHeader()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ EndThemeDragSound()

OSStatus EndThemeDragSound ( void  )

EndThemeDragSound()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetTextAndEncodingFromCFString()

OSStatus GetTextAndEncodingFromCFString ( CFStringRef  inString,
BytePtr  outText,
ByteCount  inTextMaxLength,
ByteCount *  outTextLength,
TextEncoding *  outEncoding 
)

GetTextAndEncodingFromCFString()

Summary: Converts the contents of a CFString to the one- or two-byte encoding that most accurately represents the original Unicode characters in the string.

Discussion: Because the Macintosh toolbox has had, until Carbon, little support for Unicode, you may often find that your applications need to translate a CFString (containing Unicode characters) back to a one- or two-byte encoding of the string in order to draw, measure, or otherwise use the text in the string. GetTextAndEncodingFromCFString is a utility that may be helpful to do this, in some circumstances. The Carbon toolbox uses this API itself when translating CFStrings to Pascal strings. GetTextAndEncodingFromCFString attempts to convert the Unicode characters in the string to the closest non-Unicode representation of the string. For example, a string containing only Unicode characters that are present in the MacRoman one-byte encoding will be translated to MacRoman, and kTextEncodingMacRoman will be returned as the encoding of the text. A string containing Unicode characters that are present in the MacJapanese two-byte encoding will be translated to MacJapanese (Shift-JIS), and kTextEncodingMacJapanese will be returned as the encoding of the text. GetTextAndEncodingFromCFString is designed to be used for simple strings which contain only text from a single language. It is not designed to translate strings with multiple runs of text from different languages, and will only return the first run of such a string; for example, if you pass it a string containing a run of Roman characters followed by a run of Japanese characters, it will only return the Roman characters in the output buffer. For more complex text translation, you should call the Unicode converter directly (see ConvertFromUnicodeToTextRun, which GetTextAndEncodingFromCFString uses internally).

Parameters:

inString: The string to convert.

outText: The output buffer in which to place the converted text.

inTextMaxLength: The length in bytes of the input buffer.

outTextLength: On exit, contains the length in bytes of the text that was placed into the output buffer.

outEncoding: On exit, contains the encoding of the text that was placed into the output buffer.

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.2.5 and later
Mac OS X: in version 10.0 and later

◆ GetTheme()

OSStatus GetTheme ( Collection  ioCollection)

GetTheme()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeAccentColors()

OSStatus GetThemeAccentColors ( CTabHandle outColors)

GetThemeAccentColors()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeBrushAsColor()

OSStatus GetThemeBrushAsColor ( ThemeBrush  inBrush,
SInt16  inDepth,
Boolean  inColorDev,
RGBColor outColor 
)

GetThemeBrushAsColor()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeButtonBackgroundBounds()

OSStatus GetThemeButtonBackgroundBounds ( const Rect inBounds,
ThemeButtonKind  inKind,
const ThemeButtonDrawInfo inDrawInfo,
Rect outBounds 
)

GetThemeButtonBackgroundBounds()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeButtonContentBounds()

OSStatus GetThemeButtonContentBounds ( const Rect inBounds,
ThemeButtonKind  inKind,
const ThemeButtonDrawInfo inDrawInfo,
Rect outBounds 
)

GetThemeButtonContentBounds()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeButtonRegion()

OSStatus GetThemeButtonRegion ( const Rect inBounds,
ThemeButtonKind  inKind,
const ThemeButtonDrawInfo inNewInfo,
RgnHandle  outRegion 
)

GetThemeButtonRegion()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeCheckBoxStyle()

OSStatus GetThemeCheckBoxStyle ( ThemeCheckBoxStyle *  outStyle)

GetThemeCheckBoxStyle()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeDrawingState()

OSStatus GetThemeDrawingState ( ThemeDrawingState *  outState)

GetThemeDrawingState()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeFont()

OSStatus GetThemeFont ( ThemeFontID  inFontID,
ScriptCode  inScript,
Str255  outFontName,
SInt16 *  outFontSize,
Style *  outStyle 
)

GetThemeFont()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeMenuBackgroundRegion()

OSStatus GetThemeMenuBackgroundRegion ( const Rect inMenuRect,
ThemeMenuType  menuType,
RgnHandle  region 
)

GetThemeMenuBackgroundRegion()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeMenuBarHeight()

OSStatus GetThemeMenuBarHeight ( SInt16 *  outHeight)

GetThemeMenuBarHeight()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeMenuItemExtra()

OSStatus GetThemeMenuItemExtra ( ThemeMenuItemType  inItemType,
SInt16 *  outHeight,
SInt16 *  outWidth 
)

GetThemeMenuItemExtra()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeMenuSeparatorHeight()

OSStatus GetThemeMenuSeparatorHeight ( SInt16 *  outHeight)

GetThemeMenuSeparatorHeight()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeMenuTitleExtra()

OSStatus GetThemeMenuTitleExtra ( SInt16 *  outWidth,
Boolean  inIsSquished 
)

GetThemeMenuTitleExtra()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeMetric()

OSStatus GetThemeMetric ( ThemeMetric  inMetric,
SInt32 *  outMetric 
)

GetThemeMetric()

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeScrollBarArrowStyle()

OSStatus GetThemeScrollBarArrowStyle ( ThemeScrollBarArrowStyle *  outStyle)

GetThemeScrollBarArrowStyle()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeScrollBarThumbStyle()

OSStatus GetThemeScrollBarThumbStyle ( ThemeScrollBarThumbStyle *  outStyle)

GetThemeScrollBarThumbStyle()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeScrollBarTrackRect()

OSStatus GetThemeScrollBarTrackRect ( const Rect bounds,
ThemeTrackEnableState  enableState,
ThemeTrackPressState  pressState,
Boolean  isHoriz,
Rect trackBounds 
)

GetThemeScrollBarTrackRect()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeStandaloneGrowBoxBounds()

OSStatus GetThemeStandaloneGrowBoxBounds ( Point  origin,
ThemeGrowDirection  growDirection,
Boolean  isSmall,
Rect bounds 
)

GetThemeStandaloneGrowBoxBounds()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTabRegion()

OSStatus GetThemeTabRegion ( const Rect inRect,
ThemeTabStyle  inStyle,
ThemeTabDirection  inDirection,
RgnHandle  ioRgn 
)

GetThemeTabRegion()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTextColor()

OSStatus GetThemeTextColor ( ThemeTextColor  inColor,
SInt16  inDepth,
Boolean  inColorDev,
RGBColor outColor 
)

GetThemeTextColor()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTextDimensions()

OSStatus GetThemeTextDimensions ( CFStringRef  inString,
ThemeFontID  inFontID,
ThemeDrawState  inState,
Boolean  inWrapToWidth,
Point ioBounds,
SInt16 *  outBaseline 
)

GetThemeTextDimensions()

Summary: Tells you the height, width, and baseline for a string.

Discussion: GetThemeTextDimensions measures the given string using a font and state you specify. It always reports the actual height and baseline. It sometimes reports the actual width (see below). It can measure a string that wraps. It is unicode savvy (although only partially so under CarbonLib).

Parameters:

inString: A CFStringRef containing the unicode characters you wish to measure. You MUST NOT pass in a CFStringRef that was allocated with any of the "NoCopy" CFString creation APIs (see note in DrawThemeTextBox above).

inFontID: The ThemeFontID describing the font you'd like to measure the text with. See the discussion of ThemeFontIDs elsewhere in this header.

inState: The ThemeDrawState which matches the state you will ultimately render the string width. This may affect text measurement, so you should be sure the value you pass to TruncateThemeText matches the value you will eventually use for drawing.

inWrapToWidth: A Boolean indicating whether you want the measurements based on wrapping the text to a specific width. If you pass true, you must specify the desired width in ioBounds->h.

ioBounds: On output, ioBounds->v contains the height of the text. If you pass false to inWrapToWidth, ioBounds->h will contain the width of the text on output. If you pass true to inWrapToWidth, ioBounds->h must (on input) contain the desired width for wrapping; on output, ioBounds->h contains the same value you specified on input.

outBaseline: On output, outBaseline contains the offset (in Quickdraw space) from the bottom edge of the last line of text to the baseline of the first line of text. outBaseline will generally be a negative value.

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.3 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTextShadowOutset()

OSStatus GetThemeTextShadowOutset ( ThemeFontID  inFontID,
ThemeDrawState  inState,
Rect outOutset 
)

GetThemeTextShadowOutset()

Summary: Tells you the amount of space taken up by the shadow for a given font/state combination.

Discussion: GetThemeTextShadowOutset passes back the maximum amount of space the shadow will take up for text drawn in the specified font and state. While GetThemeTextDimensions tells you how much space is taken up by the character glyphs themselves, it does not incorporate the font/state shadow into its calculations. If you need to know how much total space including the shadow will be taken up, call GetThemeTextDimensions followed by GetThemeTextShadowOutset.

Parameters:

inFontID: The ThemeFontID describing the font you'd like the shadow characteristics of. Font and state both determine the amount of shadow that will be used on rendered text. See the discussion of ThemeFontIDs elsewhere in this header.

inState: The ThemeDrawState which matches the state you'd like the shadow characteristics of. Font and state both determine the amount of shadow that will be used on rendered text.

outOutset: On output, outOutset contains the amount of space the shadow will take up beyond each edge of the text bounding rectangle returned by GetThemeTextDimensions. The fields of outOutset will either be positive values or zero.

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.3 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTrackBounds()

OSStatus GetThemeTrackBounds ( const ThemeTrackDrawInfo drawInfo,
Rect bounds 
)

GetThemeTrackBounds()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTrackDragRect()

OSStatus GetThemeTrackDragRect ( const ThemeTrackDrawInfo drawInfo,
Rect dragRect 
)

GetThemeTrackDragRect()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTrackLiveValue()

OSStatus GetThemeTrackLiveValue ( const ThemeTrackDrawInfo drawInfo,
SInt32  relativePosition,
SInt32 *  value 
)

GetThemeTrackLiveValue()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTrackThumbPositionFromOffset()

OSStatus GetThemeTrackThumbPositionFromOffset ( const ThemeTrackDrawInfo drawInfo,
Point  thumbOffset,
SInt32 *  relativePosition 
)

GetThemeTrackThumbPositionFromOffset()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTrackThumbPositionFromRegion()

OSStatus GetThemeTrackThumbPositionFromRegion ( const ThemeTrackDrawInfo drawInfo,
RgnHandle  thumbRgn,
SInt32 *  relativePosition 
)

GetThemeTrackThumbPositionFromRegion()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeTrackThumbRgn()

OSStatus GetThemeTrackThumbRgn ( const ThemeTrackDrawInfo drawInfo,
RgnHandle  thumbRgn 
)

GetThemeTrackThumbRgn()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeWindowRegion()

OSStatus GetThemeWindowRegion ( ThemeWindowType  flavor,
const Rect contRect,
ThemeDrawState  state,
const ThemeWindowMetrics metrics,
ThemeWindowAttributes  attributes,
WindowRegionCode  winRegion,
RgnHandle  rgn 
)

GetThemeWindowRegion()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ GetThemeWindowRegionHit()

Boolean GetThemeWindowRegionHit ( ThemeWindowType  flavor,
const Rect inContRect,
ThemeDrawState  state,
const ThemeWindowMetrics metrics,
ThemeWindowAttributes  inAttributes,
Point  inPoint,
WindowRegionCode *  outRegionHit 
)

GetThemeWindowRegionHit()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ HitTestThemeScrollBarArrows()

Boolean HitTestThemeScrollBarArrows ( const Rect scrollBarBounds,
ThemeTrackEnableState  enableState,
ThemeTrackPressState  pressState,
Boolean  isHoriz,
Point  ptHit,
Rect trackBounds,
ControlPartCode *  partcode 
)

HitTestThemeScrollBarArrows()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ HitTestThemeTrack()

Boolean HitTestThemeTrack ( const ThemeTrackDrawInfo drawInfo,
Point  mousePoint,
ControlPartCode *  partHit 
)

HitTestThemeTrack()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeMenuItemDrawingUPP()

void InvokeMenuItemDrawingUPP ( const Rect inBounds,
SInt16  inDepth,
Boolean  inIsColorDevice,
SInt32  inUserData,
MenuItemDrawingUPP  userUPP 
)

InvokeMenuItemDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeMenuTitleDrawingUPP()

void InvokeMenuTitleDrawingUPP ( const Rect inBounds,
SInt16  inDepth,
Boolean  inIsColorDevice,
SInt32  inUserData,
MenuTitleDrawingUPP  userUPP 
)

InvokeMenuTitleDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeThemeButtonDrawUPP()

void InvokeThemeButtonDrawUPP ( const Rect bounds,
ThemeButtonKind  kind,
const ThemeButtonDrawInfo info,
UInt32  userData,
SInt16  depth,
Boolean  isColorDev,
ThemeButtonDrawUPP  userUPP 
)

InvokeThemeButtonDrawUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeThemeEraseUPP()

void InvokeThemeEraseUPP ( const Rect bounds,
UInt32  eraseData,
SInt16  depth,
Boolean  isColorDev,
ThemeEraseUPP  userUPP 
)

InvokeThemeEraseUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeThemeIteratorUPP()

Boolean InvokeThemeIteratorUPP ( ConstStr255Param  inFileName,
SInt16  resID,
Collection  inThemeSettings,
void *  inUserData,
ThemeIteratorUPP  userUPP 
)

InvokeThemeIteratorUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeThemeTabTitleDrawUPP()

void InvokeThemeTabTitleDrawUPP ( const Rect bounds,
ThemeTabStyle  style,
ThemeTabDirection  direction,
SInt16  depth,
Boolean  isColorDev,
UInt32  userData,
ThemeTabTitleDrawUPP  userUPP 
)

InvokeThemeTabTitleDrawUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ InvokeWindowTitleDrawingUPP()

void InvokeWindowTitleDrawingUPP ( const Rect bounds,
SInt16  depth,
Boolean  colorDevice,
UInt32  userData,
WindowTitleDrawingUPP  userUPP 
)

InvokeWindowTitleDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ IsAppearanceClient()

Boolean IsAppearanceClient ( const ProcessSerialNumber process)

IsAppearanceClient()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ IsThemeInColor()

Boolean IsThemeInColor ( SInt16  inDepth,
Boolean  inIsColorDevice 
)

IsThemeInColor()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ IsValidAppearanceFileType()

Boolean IsValidAppearanceFileType ( OSType  fileType)

IsValidAppearanceFileType()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ IterateThemes()

OSStatus IterateThemes ( ThemeIteratorUPP  inProc,
void *  inUserData 
)

IterateThemes()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewMenuItemDrawingUPP()

MenuItemDrawingUPP NewMenuItemDrawingUPP ( MenuItemDrawingProcPtr  userRoutine)

NewMenuItemDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewMenuTitleDrawingUPP()

MenuTitleDrawingUPP NewMenuTitleDrawingUPP ( MenuTitleDrawingProcPtr  userRoutine)

NewMenuTitleDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewThemeButtonDrawUPP()

ThemeButtonDrawUPP NewThemeButtonDrawUPP ( ThemeButtonDrawProcPtr  userRoutine)

NewThemeButtonDrawUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewThemeEraseUPP()

ThemeEraseUPP NewThemeEraseUPP ( ThemeEraseProcPtr  userRoutine)

NewThemeEraseUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewThemeIteratorUPP()

ThemeIteratorUPP NewThemeIteratorUPP ( ThemeIteratorProcPtr  userRoutine)

NewThemeIteratorUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewThemeTabTitleDrawUPP()

ThemeTabTitleDrawUPP NewThemeTabTitleDrawUPP ( ThemeTabTitleDrawProcPtr  userRoutine)

NewThemeTabTitleDrawUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NewWindowTitleDrawingUPP()

WindowTitleDrawingUPP NewWindowTitleDrawingUPP ( WindowTitleDrawingProcPtr  userRoutine)

NewWindowTitleDrawingUPP()

Non-Carbon CFM: available as macro/inline
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ NormalizeThemeDrawingState()

OSStatus NormalizeThemeDrawingState ( void  )

NormalizeThemeDrawingState()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ PlayThemeSound()

OSStatus PlayThemeSound ( ThemeSoundKind  kind)

PlayThemeSound()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ RegisterAppearanceClient()

OSStatus RegisterAppearanceClient ( void  )

RegisterAppearanceClient()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetAnimatedThemeCursor()

OSStatus SetAnimatedThemeCursor ( ThemeCursor  inCursor,
UInt32  inAnimationStep 
)

SetAnimatedThemeCursor()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetTheme()

OSStatus SetTheme ( Collection  ioCollection)

SetTheme()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemeBackground()

OSStatus SetThemeBackground ( ThemeBrush  inBrush,
SInt16  inDepth,
Boolean  inIsColorDevice 
)

SetThemeBackground()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemeCursor()

OSStatus SetThemeCursor ( ThemeCursor  inCursor)

SetThemeCursor()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemeDrawingState()

OSStatus SetThemeDrawingState ( ThemeDrawingState  inState,
Boolean  inDisposeNow 
)

SetThemeDrawingState()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemePen()

OSStatus SetThemePen ( ThemeBrush  inBrush,
SInt16  inDepth,
Boolean  inIsColorDevice 
)

SetThemePen()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemeTextColor()

OSStatus SetThemeTextColor ( ThemeTextColor  inColor,
SInt16  inDepth,
Boolean  inIsColorDevice 
)

SetThemeTextColor()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemeTextColorForWindow()

OSStatus SetThemeTextColorForWindow ( WindowRef  window,
Boolean  isActive,
SInt16  depth,
Boolean  isColorDev 
)

SetThemeTextColorForWindow()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ SetThemeWindowBackground()

OSStatus SetThemeWindowBackground ( WindowRef  inWindow,
ThemeBrush  inBrush,
Boolean  inUpdate 
)

SetThemeWindowBackground()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ TruncateThemeText()

OSStatus TruncateThemeText ( CFMutableStringRef  inString,
ThemeFontID  inFontID,
ThemeDrawState  inState,
SInt16  inPixelWidthLimit,
TruncCode  inTruncWhere,
Boolean outTruncated 
)

TruncateThemeText()

Summary: Truncates text to fit within the width you specify.

Discussion: TruncateThemeText alters a unicode string to fit within a width that you specify. It is unicode savvy (although only partially so under CarbonLib), and makes its calculations (and any subsequent string alteration) based on the font and state you specify. If the string needs to be truncated, it will be reduced to the maximum number of characters which (with the addition of an ellipsis character) fits within the specified width.

Parameters:

inString: A CFMutableStringRef containing the unicode characters you wish to truncate. On output, inString may have been altered to fit within the specified width. You MUST NOT pass in a CFStringRef that was allocated with any of the "NoCopy" CFString creation APIs (see note in DrawThemeTextBox above).

inFontID: The ThemeFontID to use for text measurements. See the discussion of ThemeFontIDs elsewhere in this header.

inState: The ThemeDrawState which matches the state you will ultimately render the string width. This may affect text measurement during truncation, so you should be sure the value you pass to TruncateThemeText matches the value you will eventually use for drawing.

inPixelWidthLimit: The maximum width (in pixels) that the resulting truncated string may have.

inTruncWhere: A TruncCode indicating where you would like truncation to occur.

outTruncated: On output, this Boolean value indicates whether the string was truncated. True means the string was truncated. False means the string was not (and did not need to be) truncated.

Non-Carbon CFM: not available
Carbon Lib: in CarbonLib 1.3 and later
Mac OS X: in version 10.0 and later

◆ UnregisterAppearanceClient()

OSStatus UnregisterAppearanceClient ( void  )

UnregisterAppearanceClient()

Non-Carbon CFM: in AppearanceLib 1.0 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later

◆ UseThemeFont()

OSStatus UseThemeFont ( ThemeFontID  inFontID,
ScriptCode  inScript 
)

UseThemeFont()

Non-Carbon CFM: in AppearanceLib 1.1 and later
Carbon Lib: in CarbonLib 1.0 and later
Mac OS X: in version 10.0 and later