A value of type ThemeBackgroundKind. Pass a constant specifying the type of embedding object. See “Theme Backgrounds” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling ApplyThemeBackground, set the rectangle to a size and position that contains the embedding object, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the current state of the embedding object. See “Theme Drawing States” for descriptions of possible values.

A signed 16-bit integer. Pass a value specifying the bit depth (in bits per pixel) of the current graphics port.

A value of type Boolean. Pass true to indicate that you are drawing on a color device, or false for a monochrome device.

The UPP to dispose of.

The UPP to dispose of.

The UPP to dispose of.

The UPP to dispose of.

The UPP to dispose of.

The UPP to dispose of.

The UPP to dispose of.

A pointer to a structure of type Rect. Pass a rectangle specifying the boundary of the button, in local coordinates.

A value of type ThemeButtonKind. Pass a constant specifying the type of button to draw. See “Theme Buttons” for descriptions of possible values.

A pointer to a structure of type ThemeButtonDrawInfo. Before calling DrawThemeButton, set the structure to contain the new state, value, and adornment for the button. DrawThemeButton uses the information passed in the inNewInfo and inPrevInfo parameters to apply transitional animation or sound effects as the button state changes, if such are specified under the current theme.

A pointer to a structure of type ThemeButtonDrawInfo. If the button state is changing, set the structure to contain the previous state, value, and adornment for the button, to allow DrawThemeButton to apply any transitional effects. If the button state is not changing, you can pass NULL.

A value of type ThemeEraseUPP. If you have a custom background, use this parameter to pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemeButton calls this function to erase the background before drawing the button. If you pass NULL, DrawThemeButton's default behavior is to erase the background for you.

A value of type ThemeButtonDrawUPP. If you pass a universal function pointer to an application-defined function such as that described in ThemeButtonDrawProcPtr, DrawThemeButton calls that function to draw the label of the button. If you pass NULL, no label is drawn.

An unsigned 32-bit integer. Provide any data to be passed in to the callback functions specified in the inLabelProc and inEraseProc parameters. Pass NULL if you do not wish to provide any data.

A pointer to a structure of type Rect. Before calling DrawThemeChasingArrows, set the rectangle to contain the asynchronous arrows, in local coordinates.

An unsigned 32-bit value. Pass a value specifying the current animation step of the arrows. To animate the arrows, increment the initial value by 1 with each call to DrawThemeChasingArrows.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the asynchronous arrows indicator; see “Theme Drawing States.” The asynchronous arrows indicator can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemeChasingArrows calls that function to erase the background before drawing the asynchronous arrows. If you pass NULL, no erasing occurs.

An unsigned 32-bit integer. Provide any data to be passed in to the eraseData parameter of the callback function specified in the eraseProc parameter.

A pointer to a structure of type Rect. Before calling DrawThemeEditTextFrame, set the rectangle to the position around which to draw the editable text frame, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the editable text frame; see “Theme Drawing States.” The frame can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a structure of type Rect. Before calling DrawThemeFocusRect, set the rectangle to the position around which to draw the focus ring, in local coordinates. The focus ring is drawn outside the rectangle that is passed in, and it can be outset a maximum of 3 pixels.

A value of type Boolean. Pass true to draw the focus ring. Pass false to erase the focus ring.

A value of type RgnHandle. Before calling DrawThemeFocusRegion, set the region to the position around which to draw the focus ring, in local coordinates. The focus ring is drawn outside the region that is passed in, and it can be outset a maximum of 3 pixels.

A value of type Boolean. Pass true to draw the focus region. Pass false to erase the focus region.

A pointer to a structure of type Rect. Before calling DrawThemeGenericWell, set the rectangle to the position around which to draw the image well frame, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the image well frame; see “Theme Drawing States.” The well can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A value of type Boolean. Set to true to fill the image well frame with white; otherwise, false.

A pointer to a structure of type Rect. Before calling DrawThemeListBoxFrame, set the rectangle to the position around which to draw the list box frame, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the list box frame; see “Theme Drawing States.” The frame can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a structure of type Rect. Before calling DrawThemeMenuBackground, set the rectangle to contain the entire menu, in global coordinates.

A value of type ThemeMenuType. Pass a constant specifying the type of menu for which to draw a background; see “Theme Menu Types” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling DrawThemeMenuBarBackground, set the rectangle to specify the menu bar’s initial size and location, in global coordinates.

A value of type ThemeMenuBarState. Pass a constant specifying the state (active or selected) in which to draw the menu bar; see “Theme Menu Bar States.”

A value indicating the attributes of the menu bar. Pass 0 for a standard menu bar or kThemeMenuSquareMenuBar for a menu bar with square corners.

A pointer to a structure of type Rect. Before calling DrawThemeMenuItem, set the rectangle to contain the entire menu, in global coordinates. This is the actual menu rectangle as used in your menu definition function.

A pointer to a structure of type Rect. Before calling DrawThemeMenuItem, set the rectangle to contain the menu item, in global coordinates. The menu item’s background is drawn in the rectangle passed in the inItemRect parameter. You should calculate the size of the menu item’s content and then call GetThemeMenuItemExtra to get the amount of padding surrounding menu items in the current theme; the width and height of the menu item rectangle are determined by adding these values together.

A signed 16-bit integer. Pass a value representing the actual top of the menu. Normally this value is the top coordinate of the rectangle supplied in the inMenuRect parameter. This value could be different, however, if a menu is scrolled or bigger than can be displayed in the menu rectangle. You typically pass the value of the global variable TopMenuItem into this parameter if you are writing a custom menu definition function.

A signed 16-bit integer. Pass a value representing the actual bottom of the menu. Typically this value is the bottom coordinate of the rectangle supplied in the inMenuRect parameter. This value could be different, however, if a menu is scrolled or bigger than can be displayed in the menu rectangle. You typically pass the value of the global variable AtMenuBottom into this parameter if you are writing a custom menu definition function.

A value of type ThemeMenuState. Pass a constant specifying the state (active, selected, or disabled) in which to draw the menu item; see “Theme Menu States.”

A value of type ThemeMenuItemType. If you pass kThemeMenuItemScrollUpArrow or kThemeMenuItemScrollDownArrow, then you should pass NULL for the inDrawProc parameter, since there is no content to be drawn. If you pass kThemeMenuItemHierarchical, the hierarchical arrow is drawn for you. See “Theme Menu Item Types” for descriptions of possible values.

A value of type MenuItemDrawingUPP. Pass a universal function pointer to a menu item drawing function such as MenuItemDrawingProcPtr. The value of the inDrawProc parameter can be a valid universal function pointer or NULL.

An unsigned 32-bit integer. Provide any data to be passed in to the inUserData parameter of MenuItemDrawingProcPtr.

A pointer to a structure of type Rect. Before calling DrawThemeMenuSeparator, set the rectangle to contain the menu item separator to be drawn, in global coordinates. The rectangle should be the same height as the height returned by the function GetThemeMenuSeparatorHeight.

A pointer to a structure of type Rect. Before calling DrawThemeMenuTitle, set the rectangle to contain the entire menu bar in which the title is to be drawn, in global coordinates. The menu bar background is drawn in the rectangle passed in the inMenuBarRect parameter. Your application can call GetThemeMenuBarHeight to get the height of the menu bar.

A pointer to a structure of type Rect. Before calling DrawThemeMenuTitle, set the rectangle to contain the menu title, in global coordinates. The title background is drawn in the rectangle passed in the inTitleRect parameter. The width of this rectangle is determined by calculating the width of the menu title’s content and then calling GetThemeMenuTitleExtra to get the amount of padding between menu titles in the current theme; these two values are added together and added to the left edge of where the title should be drawn. The top and bottom coordinates of this rectangle should be the same as those of the inMenuBarRect parameter.

A value of type ThemeMenuState. Pass a constant specifying the state (active, selected, or disabled) in which to draw the menu title; see “Theme Menu States.”

Reserved. Pass 0.

A value of type MenuTitleDrawingUPP. Pass a universal function pointer to a menu title drawing function such as MenuTitleDrawingProcPtr, defining how to draw the contents of the menu title. The value of the inTitleProc parameter can be a valid universal function pointer or NULL.

An unsigned 32-bit integer. Provide any data to be passed in to the inUserData parameter of MenuTitleDrawingProcPtr.

A pointer to a structure of type Rect. Before calling DrawThemeModelessDialogFrame, set the rectangle to the boundary of the window’s content area (that is, its port rectangle), inset by 1 pixel on each side, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the modeless dialog box frame; see “Theme Drawing States” for descriptions of possible values. The frame can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a structure of type Rect. Before calling DrawThemePlacard, set the rectangle to a size and position that contains the placard, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the placard; see “Theme Drawing States.” The placard can be drawn as active, inactive, or pressed.

A pointer to a structure of type Rect. Before calling DrawThemePopupArrow, set the rectangle to contain the arrow, in local coordinates. DrawThemePopupArrow positions the arrow relative to the top left corner of the rectangle.

A value of type ThemeArrowOrientation. Pass a constant specifying the direction in which the pop-up arrow points. See “Theme Pop-Up Arrow Orientations” for descriptions of possible values.

A value of type ThemePopupArrowSize. Pass a constant specifying the size of the pop-up arrow to draw. See “Theme Pop-Up Arrow Sizes” for descriptions of possible values.

A value of type ThemeDrawState. Pass a constant specifying the current state of the button containing the pop-up arrow. See “Theme Drawing States” for descriptions of possible values.

A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemePopupArrow calls that function to erase the background before drawing the pop-up arrow. If you pass NULL, no erasing occurs.

An unsigned 32-bit integer. Provide any data to be passed in to the eraseData parameter of the callback function specified in the eraseProc parameter.

A pointer to a structure of type Rect. Before calling DrawThemePrimaryGroup, set the rectangle to the bounds of the primary group box frame, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the primary group box frame; see “Theme Drawing States.” The frame can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a structure of type Rect. Before calling DrawThemeScrollBarArrows, set the rectangle to contain the scroll bar for which to draw arrows, in local coordinates. Typically, the rectangle you specify is the entire base control rectangle—that is, the value contained in the contrlRect field of the scroll bar’s ControlRecord structure.

A value of type ThemeTrackEnableState. Pass a constant specifying the current state of the scroll bar; see “Theme Track States” for descriptions of possible values.

A value of type ThemeTrackPressState. Pass a constant specifying what is pressed in an active scroll bar or 0 if nothing is pressed. The press state is ignored if the scroll bar is not active. See “Theme Track Press States” for descriptions of possible values.

A value of type Boolean. Pass true if the scroll bar is horizontal; pass false if it is vertical.

A pointer to a structure of type Rect. On return, the rectangle is set to the bounds of the track portion of the scroll bar; this rectangle excludes the area containing the scroll bar arrows. Pass NULL if you do not wish to obtain this information.

A value of type ThemeWindowType. Pass a constant specifying the type of window for which to draw scroll bar delimiters. See “Theme Window Types” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling DrawThemeScrollBarDelimiters, set the rectangle to the boundary of the content rectangle of the window, in local coordinates.

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the window. The scroll bar delimiters can be drawn as active or inactive passing kThemeStatePressed produces an error. See “Theme Drawing States” for descriptions of these values.

A value of type ThemeWindowAttributes. Pass one or more constants corresponding to the window’s current visual attributes. See “Theme Window Attributes” for descriptions of possible values. Pass 0 if the window has none of the enumerated attributes.

A pointer to a structure of type Rect. Before calling DrawThemeSecondaryGroup, set the rectangle to the bounds of the secondary group box frame to be drawn, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the secondary group box frame; see “Theme Drawing States.” The frame can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a structure of type Rect. Before calling DrawThemeSeparator, set the rectangle to contain the separator line, in local coordinates. The orientation of the rectangle determines where the separator line is drawn. If the rectangle is wider than it is tall, the separator line is horizontal; otherwise it is vertical.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the separator line; see “Theme Drawing States.” The separator line can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A structure of type Point. Pass the origin point of the size box rectangle. For example, the origin point of the size box for an object that can grow downward and to the right is the size box’s upper-left corner. Typically, you use the coordinates of the corner of whatever object owns the size box for the origin value. For example, if you are drawing a scrolling list that can grow downward and to the right, the origin value would be the coordinates of the bottom-right corner of the list.

A value of type ThemeGrowDirection. Pass a constant specifying the direction(s) in which the resizeable object can grow. See “Theme Size Box Directions” for descriptions of possible values. The Appearance Manager uses the growDirection parameter to establish which corner of the size box is the origin.

A value of type Boolean. Pass a value of true to specify a small size box (typically for use with small scroll bars) or false to specify a standard size box.

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the size box the size box cannot be drawn as pressed. See “Theme Drawing States” for descriptions of these values.

A structure of type Point. Pass the origin point of the rectangle in which to draw the image. Typically, you use the coordinates of the corner of whatever object owns the image for the origin value. For example, if you are drawing the image in the bottom-right corner of a window between the scroll bars of a non-resizeable scrolling list, the origin value would be the coordinates of the bottom-right corner of the list.

A value of type ThemeGrowDirection. See “Theme Size Box Directions” for descriptions of possible values. The Appearance Manager uses the growDirection parameter to establish which corner of the rectangle that contains the image is the origin.

A value of type Boolean. Pass a value of true to specify a small image (for use with small scroll bars) or false to specify a large image (for use with standard scroll bars).

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the window containing the fill image the image cannot be drawn as pressed. See “Theme Drawing States” for descriptions of these values.

A pointer to a structure of type Rect. Before calling DrawThemeTab, set the rectangle to the bounds of the tab, in local coordinates. There are two standard sizes (or heights) for tabs that should be used in your calculation of the tab rectangle—these are measured by the distance the tabs protrude from the pane. Small tabs have a height of 16 pixels large tabs have a height of 21 pixels. (The widths of tabs are variable.) Additionally, the distance that the tab overlaps the pane must be included in the tab rectangle this overlap distance is always 3 pixels, although the 3-pixel overlap is only drawn for the front tab. The tab rectangle should reflect the orientation of the tab that is specified in the inDirection parameter.

A value of type ThemeTabStyle. Pass a constant specifying the relative position (front or non-front) and state of the tab. See “Theme Tab Styles” for descriptions of possible values.

A value of type ThemeTabDirection. Pass a constant specifying the direction in which to orient the tab. See “Theme Tab Directions” for descriptions of possible values.

A value of type ThemeTabTitleDrawUPP. Pass a universal function pointer to an application-defined function such as that described in ThemeTabTitleDrawProcPtr. DrawThemeTab calls your function to draw the title of the tab. If you pass NULL, no drawing occurs.

An unsigned 32-bit integer. Provide any data to be passed in to the userData parameter of the callback function specified in the labelProc parameter.

A pointer to a structure of type Rect. Before calling DrawThemeTabPane, set the rectangle to the bounds of the tab pane, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the tab pane; see “Theme Drawing States.” The tab pane can be drawn as active or inactive; passing kThemeStatePressed produces an error.

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 functions; a string created with a "NoCopy" function has transient storage which is incompatible with DrawThemeTextBox's caches.

The ThemeFontID describing the font you'd like to render the text with. See “Theme Font IDs” for the values you can use here.

The ThemeDrawState describing 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.

See “Theme Drawing States” for the values you can use here.

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.

A Boolean value 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.

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.

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

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 function call. Relying on the system behavior if transiently creating CGContextRefs may result in performance problems. On Mac OS 9, this parameter is ignored.

A pointer to a structure of type Rect. Before calling DrawThemeTickMark, set the rectangle to the position that contains the tick mark, in local coordinates. Note that tick marks are of a fixed—3 pixel by 8 pixel—size.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the tick mark; see “Theme Drawing States.” The tick mark can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A value of type ThemeWindowType. Pass a constant specifying the type of window for which to draw a title bar item. See “Theme Window Types” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling DrawThemeTitleBarWidget, specify the rectangle for which you wish to draw a title bar item, in coordinates local to the current port. This rectangle is typically the content rectangle of a window.

A value of type ThemeDrawState. Pass a constant— kThemeStateActive, kThemeStateInactive, or kThemeStatePressed—appropriate to the current state of the title bar item. See “Theme Drawing States” for descriptions of these values.

A pointer to a structure of type ThemeWindowMetrics. Before calling DrawThemeTitleBarWidget, set the structure to contain information describing the window for which you wish to draw a title bar item.

A value of type ThemeWindowAttributes. Pass one or more constants corresponding to the window’s current visual attributes. See “Theme Window Attributes” for descriptions of possible values. Pass 0 if the window has none of the enumerated attributes.

A value of type ThemeTitleBarWidget. Pass a constant—kThemeWidgetCloseBox, kThemeWidgetZoomBox, or kThemeWidgetCollapseBox—appropriate to the type of title bar item you wish to draw. See “Theme Title Bar Items” for descriptions of these values.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling DrawThemeTrack, set the structure to contain the current visual characteristics of the track.

A value of type RgnHandle. If the track is of a type that contains an indicator, such as a scroll bar or slider, you may pass a handle to the region where DrawThemeTrack is to draw a ghost image of the track indicator. Your application should only use a ghost image with the indicator when a track does not support live feedback. Pass NULL if you do not want to draw a ghost image.

A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemeTrack calls that function to erase the background before drawing the track. If you pass NULL, no erasing occurs.

An unsigned 32-bit integer. Provide any data to be passed in to the callback function specified in the eraseProc parameter.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling DrawThemeTrackTickMarks, set the structure to describe the current visual characteristics of the track. Because, under Appearance Manager 1.1, sliders are the only track type to support tick marks, you should set the kind field of the ThemeTrackDrawInfo structure to kThemeSlider and fill out the remainder of the structure appropriately for a slider track. You should set the bounds field of the ThemeTrackDrawInfo structure to the boundary of the track itself, not including the area that contains the tick marks; you can obtain the actual bounding rectangle of the track by calling the function GetThemeTrackBounds. DrawThemeTrackTickMarks draws the tick marks outside the track’s bounding rectangle, above or below the track depending on the thumb direction indicated by the drawInfo.trackInfo.slider.thumbDir field.

A value of type ItemCount. Pass an unsigned 32-bit value specifying the number of tick marks to be drawn.

A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemeTrackTickMarks calls that function to erase the background before drawing tick marks. If you pass NULL, no erasing occurs.

An unsigned 32-bit integer. Provide any data to be passed in to the callback function specified in the eraseProc parameter.

A value of type ThemeWindowType. Pass a constant specifying the type of window for which to draw a frame. See “Theme Window Types” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling DrawThemeWindowFrame, specify the rectangle for which you wish to draw a window frame, in coordinates local to the current port. This rectangle is typically the content rectangle of a window.

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the window. See “Theme Drawing States” for descriptions of these values.

A pointer to a structure of type ThemeWindowMetrics. Before calling DrawThemeWindowFrame, set the structure to describe the window for which to draw a frame.

A value of type ThemeWindowAttributes. Pass one or more constants corresponding to the window’s current visual attributes. See “Theme Window Attributes” for descriptions of possible values. Pass 0 if the window has none of the enumerated attributes.

A value of type WindowTitleDrawingUPP. If you pass the value kThemeWindowHasTitleText in the attributes parameter, you should pass a universal function pointer to an application-defined function such as that described in WindowTitleDrawingProcPtr in the titleProc parameter. DrawThemeWindowFrame calls that function to draw the window’s title. Pass NULL if there is no title to be drawn.

An unsigned 32-bit integer. Provide any data to be passed in to the userData parameter of the callback function specified in the titleProc parameter.

A pointer to a structure of type Rect. Before calling DrawThemeWindowHeader, specify the rectangle containing the window header, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the window header; see “Theme Drawing States.” The header can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a structure of type Rect. Before calling DrawThemeWindowListViewHeader, specify the rectangle in which to draw the window list view header, in local coordinates.

A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the window list view header; see “Theme Drawing States.” The header can be drawn as active or inactive; passing kThemeStatePressed produces an error.

A pointer to a value of type CTabHandle. On return, the handle refers to a ColorTable structure containing the current accent colors.

A pointer to a structure of type Rect. Before calling GetThemeButtonBackgroundBounds, set the rectangle to the boundary of the button without any adornments, in local coordinates.

A value of type ThemeButtonKind. Pass a constant specifying the type of button being examined. See “Theme Buttons” for descriptions of possible values.

A pointer to a structure of type ThemeButtonDrawInfo. Before calling GetThemeButtonBackgroundBounds, set the structure to contain the state, value, and adornment for the button.

A pointer to a structure of type Rect. On return, the rectangle contains the actual boundary of the button, including any adornments, in local coordinates.

A pointer to a structure of type Rect. Before calling GetThemeButtonContentBounds, set the rectangle to contain the boundary of the button, in local coordinates.

A value of type ThemeButtonKind. Pass a constant specifying the type of button being examined. See “Theme Buttons” for descriptions of possible values.

A pointer to a structure of type ThemeButtonDrawInfo. Before calling GetThemeButtonContentBounds, set the structure to contain the state, value, and adornment for the button.

A pointer to a structure of type Rect. On return, the rectangle contains the actual boundary, in local coordinates, of the area of the button’s face in which content can be drawn.

A pointer to a structure of type Rect. Before calling GetThemeButtonRegion, set the rectangle to the boundary of the button without any adornments, in local coordinates.

A value of type ThemeButtonKind. Pass a constant specifying the type of button being examined. See “Theme Buttons” for descriptions of possible values.

A pointer to a structure of type ThemeButtonDrawInfo. Before calling GetThemeButtonRegion, set the structure to contain the state, value, and adornment for the button.

A value of type RgnHandle. On return, the region contains the actual dimensions and position of the button and any adornments, in local coordinates.

A value of type ThemeFontID. Pass a constant specifying the kind of font (that is, the current large, small, or small emphasized system fonts or the views font) for which you wish to retrieve the current font name, size, and style in use.

A value of type ScriptCode. Pass a script code identifying the script system for which you wish obtain font information. You may pass the metascript code smSystemScript to specify the system script.

A value of type StringPtr. Pass a pointer to a Pascal string. On return, the string contains the name of the font in use. Pass NULL if you do not wish to obtain this information.

A pointer to a signed 16-bit integer. On return, the integer value specifies the size of the font in use. Pass NULL if you do not wish to obtain this information.

A pointer to a value of type Style. On return, the value specifies the style of the font in use. Pass NULL if you do not wish to obtain this information.

A pointer to a structure of type Rect. Before calling GetThemeMenuBackgroundRegion, set the rectangle to contain the entire menu, in global coordinates.

A value of type ThemeMenuType. Pass a constant specifying the type of menu (pull-down, pop-up, or hierarchical) whose background you wish to obtain; see “Theme Menu Types” for descriptions of possible values.

A value of type RgnHandle. Pass a region handle created by your application. On return, the region is set to that of the rectangle specified in the inMenuRect parameter, that is, the menu’s background region.

A pointer to a structure of type Rect. Before calling GetThemeScrollBarTrackRect, set the rectangle to the boundary of the scroll bar, in local coordinates. Typically, the rectangle you specify is the entire base control rectangle—that is, the value contained in the contrlRect field of the track’s ControlRecord structure.

A value of type ThemeTrackEnableState. Pass a constant specifying the current state of the scroll bar; see “Theme Track States” for descriptions of possible values.

A value of type ThemeTrackPressState. Pass a constant specifying what is pressed in an active scroll bar or 0 if nothing is pressed; the press state is ignored if the scroll bar is not active. See “Theme Track Press States” for descriptions of possible values.

A value of type Boolean. Pass true if the scroll bar is horizontal; pass false if it is vertical.

A pointer to a structure of type Rect. On return, the structure contains the rectangle that bounds the track portion of the scroll bar. Note that the rectangle produced does not include in its bounds any tick marks that a track (such as a slider) might have; tick marks are drawn outside the track rectangle. Similarly, for a scroll bar, the rectangle produced does not contain the scroll bar arrows, just the track itself.

A structure of type Point. Pass the origin point of the size box rectangle. For example, the origin point of the size box for an object that can grow downward and to the right is the size box’s upper-left corner. Typically, you use the coordinates of the corner of whatever object owns the size box for the origin value; for instance, if you are drawing a scrolling list that can grow downward and to the right, the origin value would be the coordinates of the bottom-right corner of the list.

A value of type ThemeGrowDirection. For a size box, pass a constant specifying the direction(s) in which the window can grow. See “Theme Size Box Directions” for descriptions of possible values. The Appearance Manager uses the growDirection parameter to establish which corner of the size box is the origin.

A value of type Boolean. Pass a value of true to specify a small size box or fill image. Pass false to specify a large size box or fill image.

A pointer to a structure of type Rect. On return, the rectangle contains the boundary of the size box or fill image.

A pointer to a structure of type Rect. Before calling GetThemeTabRegion, set the rectangle to the boundary of the tab, in local coordinates.

A value of type ThemeTabStyle. Pass a constant specifying the relative position (front or non-front) and state of the tab to be examined. See “Theme Tab Styles” for descriptions of possible values.

A value of type ThemeTabDirection. Pass a constant specifying the direction in which the tab is oriented. See “Theme Tab Directions” for descriptions of possible values.

A value of type RgnHandle. On return, the region contains the actual dimensions and position of the tab, in local coordinates.

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 functions, as mentioned in the description of the DrawThemeTextBox function.

The ThemeFontID describing the font you'd like to measure the text with. See “Theme Font IDs” for the values you can use here.

The ThemeDrawState which matches the state you will ultimately render the string with. Drawing state may affect text measurement, so you should be sure the value you pass to GetThemeTextDimensions matches the value you will eventually use for drawing. See “Theme Drawing States” for the values you can use here.

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.

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

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.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackBounds, set the structure to describe the current visual characteristics of the track. Typically, the rectangle you specify in ThemeTrackDrawInfo.bounds is the proposed bounding rectangle for the track. GetThemeTrackBounds examines this rectangle to determine the actual bounds that the track would occupy. Depending on the track type, the actual bounding rectangle for a track might contain an absolute or fixed value (as for the height of a progress bar, which is always 14 pixels). Or, the track bounds might scale (as for a scroll bar) to fit the proposed bounds.

A pointer to a structure of type Rect. On return, the rectangle contains the actual boundary of the track, in local coordinates. Note that the rectangle produced does not include in its bounds any tick marks that a track (such as a slider) might have; tick marks are drawn outside the track rectangle. Similarly, for a scroll bar, the rectangle produced does not contain the scroll bar arrows, just the track itself.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackDragRect, set the structure to contain the current visual characteristics of the track.

A pointer to a structure of type Rect. On return, the rectangle contains the actual boundary of the indicator’s drag rectangle, in local coordinates.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackLiveValue, set the structure to contain the current visual characteristics of the track.

A signed 32-bit value. Pass the distance, in pixels, between the minimum end of the track and the near side of the indicator. You may obtain this value by calling either of the functions GetThemeTrackThumbPositionFromOffset or GetThemeTrackThumbPositionFromRegion.

A pointer to a signed 32-bit value. On return, this value contains the new value of the indicator.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackThumbPositionFromOffset, set the structure to contain the current visual characteristics of the track.

A structure of type Point. Pass the point (in coordinates local to the control’s window) that specifies the vertical and horizontal offset, in pixels, by which the indicator has moved from its current position. Typically, this is the offset between the locations where the cursor was when the user pressed and released the mouse button while dragging the indicator.

A pointer to a signed 32-bit value. On return, this value contains the new distance, in pixels, between the minimum end of the track and the near side of the indicator.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackThumbPositionFromRegion, set the structure to contain the current visual characteristics of the track.

A value of type RgnHandle. Before calling GetThemeTrackThumbPositionFromRegion set the region to contain the actual dimensions and position of the indicator, in local coordinates.

A pointer to a signed 32-bit value. On return, this value contains the new distance, in pixels, between the minimum end of the track and the near side of the indicator.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackThumbRgn, set the structure to contain the current visual characteristics of the track.

A value of type RgnHandle. On return, the region contains the actual dimensions and position of the indicator, in local coordinates.

A value of type ThemeWindowType. Pass a constant specifying the type of window to be examined. See “Theme Window Types” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling GetThemeWindowRegion, set the rectangle to the content area of the window, specified in coordinates local to the current port.

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the window. See “Theme Drawing States” for descriptions of these values.

A pointer to a structure of type ThemeWindowMetrics. Before calling GetThemeWindowRegion, set the structure to contain information describing the window.

A value of type ThemeWindowAttributes. Pass one or more constants corresponding to the window’s current visual attributes. See “Theme Window Attributes” for descriptions of possible values. Pass 0 if the window has none of the enumerated attributes.

A value of type WindowRegionCode. Pass a constant specifying the region of the window whose dimensions you wish to obtain.

A value of type RgnHandle. Pass a handle to a valid region. On return, the region represents the actual region requested.

A value of type ThemeWindowType. Pass a constant specifying the type of window to be examined. See “Theme Window Types” for descriptions of possible values.

A pointer to a structure of type Rect. Before calling GetThemeWindowRegionHit, set rectangle to the content area of the window, specified in coordinates local to the current port.

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the window. See “Theme Drawing States” for descriptions of these values.

A pointer to a structure of type ThemeWindowMetrics. Before calling GetThemeWindowRegionHit, set the structure to contain information describing the window.

A value of type ThemeWindowAttributes. Pass one or more constants corresponding to the window’s current visual attributes. See “Theme Window Attributes” for descriptions of possible values. Pass 0 if the window has none of the enumerated attributes.

A structure of type Point. Pass the point, specified in specified in coordinates local to the current port, where the mouse-down event occurred. Your application may retrieve this value from the where field of the event structure.

A pointer to a value of type WindowRegionCode. On return, the value is set to the region code of the window part in which the point passed in the inPoint parameter is located.

A pointer to a structure of type Rect. Before calling HitTestThemeScrollBarArrows, set the rectangle to the boundary of the scroll bar, in local coordinates. Typically, the rectangle you specify is the entire base control rectangle—that is, the value contained in the contrlRect field of the scroll bar’s ControlRecord structure.

A value of type ThemeTrackEnableState. Pass a constant specifying the current state of the scroll bar; see “Theme Track States” for descriptions of possible values.

A value of type ThemeTrackPressState. Pass a constant specifying what is pressed in an active scroll bar or 0 if nothing is pressed; the press state is ignored if the scroll bar is not active. See “Theme Track Press States” for descriptions of possible values.

A value of type Boolean. Pass true if the scroll bar is horizontal; pass false if it is vertical.

A structure of type Point. Pass the point, specified in local coordinates, where the mouse-down event occurred. Your application may retrieve this value from the where field of the event structure.

A pointer to a structure of type Rect. On return, the rectangle contains the bounds of the track portion of the scroll bar; this rectangle excludes the area containing the scroll bar arrows. Pass NULL if you do not wish to obtain this information.

A pointer to a value of type ControlPartCode. On return, this value specifies the arrow in which the mouse-down event occurred.

A pointer to a structure of type ThemeTrackDrawInfo. Before calling HitTestThemeTrack, set the structure to contain the current visual characteristics of the track.

A structure of type Point. Pass the point, specified in local coordinates, where the mouse-down event occurred. Your application may retrieve this value from the where field of the event structure.

A pointer to a value of type ControlPartCode. On return, this value specifies the part of the track in which the mouse-down event occurred.

A pointer to a value of type ProcessSerialNumber. Pass the serial number of the process to examine.

A signed 16-bit integer. Pass a value specifying the bit depth (in bits per pixel) of the current graphics port.

A value of type Boolean. Pass true to indicate that you are drawing on a color device, or false for a monochrome device.

A four-character code. Pass the file type to be examined.

A universal function pointer to an application-defined function such as that described in ThemeIteratorProcPtr. IterateThemes calls the specified function for each theme found installed in the system.

A pointer to data of any type. Provide any data to be passed in to the inUserData parameter of the callback function specified in the inProc parameter. Pass NULL, if you do not wish to provide any data.

A value of type Collection. Pass a reference to a collection object, such as that created by calling the Collection Manager function NewCollection. Before calling SetTheme, set the collection to contain theme data that you wish to use for the current theme. The theme data is in the form of collection items, each corresponding to an attribute of the theme. For a given theme, the actual number of collection items may vary, depending upon how fully the theme’s attributes are specified. Your application can use theme collection tags, along with various Collection Manager functions, to access the data in the collection. See “Theme Collection Tags” for descriptions of the possible theme collection items.

A value of type ThemeBrush. Pass a constant specifying the theme brush to which to set the background; see “Theme Brushes” for descriptions of possible values.

A signed 16-bit integer. Pass a value specifying the bit depth (in bits per pixel) of the current graphics port.

A value of type Boolean. Pass true to indicate that you are drawing on a color device. Pass false for a monochrome device.

A value of type ThemeBrush. Pass a constant specifying the theme brush type to which to set the pen; see “Theme Brushes” for descriptions of possible values.

A signed 16-bit integer. Pass a value specifying the bit depth (in bits per pixel) of the current graphics port.

A value of type Boolean. Pass true to indicate that you are drawing on a color device. Pass false for a monochrome device.

A value of type ThemeTextColor. Pass a constant specifying an interface element. SetThemeTextColor sets the current text color to be the same as the color of that element’s text. See “Theme Text Colors” for descriptions of possible values.

A signed 16-bit integer. Pass a value specifying the bit depth (in bits per pixel) of the current graphics port.

A value of type Boolean. Pass true to indicate that you are drawing on a color device. Pass false for a monochrome device.

A CFMutableStringRef containing the unicode characters you wish to truncate. On output, this string may have been altered to fit within the specified width.

You must not pass in a CFString that was allocated with any of the "NoCopy" CFString creation functions, as mentioned in the description of the DrawThemeTextBox function.

The ThemeFontID to use for text measurements. See “Theme Font IDs” for the values you can use here.

The ThemeDrawState which matches the state you will ultimately render the string with. 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. See “Theme Drawing States” for the values you can use here.

The maximum width, in pixels, that the resulting truncated string may have.

A TruncCode indicating where you would like truncation to occur.

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.

A value of type ThemeFontID. Pass a constant specifying the kind of font (that is, the current large, small, or small emphasized system fonts or the views font) to be applied to the current port. See “Theme Font IDs” for descriptions of possible values.

A value of type ScriptCode. Pass a script code specifying the script system for which you wish to set the current font; you may pass the metascript code smSystemScript to specify the system script.