Carbon


DrawThemeListBoxFrame

Header: Appearance.h Carbon status: Supported

Draws a list box frame.

OSStatus DrawThemeListBoxFrame (
    const Rect *inRect, 
    ThemeDrawState inState
);
Parameter descriptions
inRect

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.

inState

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

function result

A result code.

DISCUSSION

The DrawThemeListBoxFrame function draws a theme-compliant list box frame. The frame is a maximum of 2 pixels thick and is drawn outside the specified rectangle. To ensure that you get an appropriate focus ring for your list box, you should pass the same rectangle that you use with the DrawThemeListBoxFrame function to the function DrawThemeFocusRect.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)