Inside Macintosh: More Macintosh Toolbox /

Chapter 5 - Icon Utilities

This chapter describes how your application can use the Icon Utilities to draw icons, including small, large, black-and-white, and color icons. The Finder draws and manages the icons that a user sees on the desktop, but if your application needs to display icons within its windows, it can use Icon Utilities routines to draw them.

For information on how to create icons and associate them with your application and its document, see the chapter "Finder Interface" in Inside Macintosh: Macintosh Toolbox Essentials. For information on how to design icons, see the chapter "Icons" in Macintosh Human Interface Guidelines.

This chapter begins with a brief overview of the various kinds of icons you can provide. The rest of the chapter describes how you can draw each kind of icon.

---

Chapter Contents

Introduction to the Icon Utilities

About the Icon Utilities

Using the Icon Utilities

Drawing Icons in an Icon Family

Drawing an Icon Directly From a Resource

Getting an Icon Suite and Drawing One of Its Icons

Drawing Specific Icons From an Icon Family

Manipulating Icons

Drawing Icons That Are Not Part of an Icon Family

Icon Utilities Reference

Data Structure

The Color Icon Record

Icon Utilities Routines

Drawing Icons From Resources

Getting Icons From Resources That Don't Belong to an Icon Family

Disposing of Icons

Creating an Icon Suite

Getting Icons From an Icon Suite

Drawing Icons From an Icon Suite

Performing Operations on Icons in an Icon Suite

Getting and Setting the Label for an Icon Suite

Getting Label Information

Disposing of Icon Suites

Converting an Icon Mask to a Region

Determining Whether a Point or Rectangle Is Within an Icon

Working With Icon Caches

Application-Defined Routines

Icon Action Functions

Icon Getter Functions

Summary of the Icon Utilities

Pascal Summary

Constants

Data Types

Icon Utilities Routines

Application-Defined Routines

C Summary

Constants

Data Types

Icon Utilities Routines

Application-Defined Routines

Assembly-Language Summary

Data Structure

Trap Macros

Result Codes