Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: More Macintosh Toolbox /

Chapter 5 - Icon Utilities / Icon Utilities Reference

Determining Whether a Point or Rectangle Is Within an Icon
You can use several Icon Utilities routines to perform hit-testing for points or rectangles against a specified icon. You specify a destination rectangle and alignment of the icon within the rectangle as parameters to these functions. The functions use this information to determine whether a specified point or rectangle is within the icon as it appears in the destination rectangle.
The PtInIconSuite and PtInIconID functions hit-test a specified point against the appropriate icon mask from an icon suite or icon family. The PtInIconMethod function hit-tests a specified point against an icon mask obtained with the aid of your icon getter function.
The RectInIconSuite and RectInIconID functions hit-test a specified rectangle against the appropriate icon mask from an icon suite or icon family. The RectInIconMethod function hit-tests a specified rectangle against an icon mask obtained with the aid of your icon getter function.

Subtopics

PtInIconSuite

PtInIconID

PtInIconMethod

RectInIconSuite

RectInIconID

RectInIconMethod

Shop the Apple Online Store (1-800-MY-APPLE), visit an Apple Retail Store, or find a reseller.