Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 5 - Icon Utilities / Icon Utilities Reference

Application-Defined Routines

Icon Getter Functions

If you use icon caches, you must provide at least one icon getter function. You provide a pointer to an icon getter function as a parameter to the MakeIconCache function. Subsequent calls to Icon Utilities routines that use icon types not present in the icon cache use the icon getter function associated with the icon cache to return a handle to the icon data.

You can also specify an icon getter function as a parameter to Icon Utilities routines that end in Method. Like Icon Utilities routines that work with icon caches, the icon getter function that you provide as a parameter to PlotIconMethod should return a handle to the requested icon's data. Note that the icon getter function that you provide as a parameter to IconMethodToRgn, PtInIconMethod, and RectInIconMethod should also return a handle to the requested icon; these three functions then extract the icon mask from the icon data your icon getter function returns.

---

Subtopics

MyIconGetter