Inside Macintosh: Programmer's Guide to MacApp / Part 2 - Working With MacApp

Chapter 21 -
Working With the Cursor

This chapter describes how MacApp's application, window, and view classes work together to efficiently track the cursor and change the cursor image. It also includes recipes and sample code that demonstrate how to

• define a new cursor resource
• associate a cursor image with a view
• set the cursor image over a view
• set the cursor image over a shape within a view
• display a color cursor
• display the cursor region, sleep region, help region, and invalid region in a debug version of your application
• modify the behavior of MacApp's default busy cursor handling

MacApp's cursor-handling capabilities are described in detail in "Cursor Handling," beginning on page 221.

For information on working with the cursor for drag-and-drop operations, see Chapter 9, "Drag and Drop," and the recipes in Chapter 28, "Working With Drag and Drop."

---

Chapter Contents

Overview

MacApp's Cursor-Handling Support

Application Fields and Methods

View Fields and Methods

Window Fields and Methods

Setting the Cursor Image for a View

Color Cursors

Recipes--The Cursor

Recipe--Defining a Cursor Resource

Recipe--Associating a Cursor Image With a View

Recipe--Setting the Cursor Image Over a View

Overriding the DoSetCursor Method in Your View Class

Recipe--Setting the Cursor Image Over a Shape Within a View

Defining a Method to Determine if the Cursor Is Over a Shape

Overriding the DoSetCursor Method in the View Class

Recipe--Displaying a Color Cursor

Recipe--Displaying Cursor Regions in a Debug Application

Recipe--Modifying Busy Cursor Behavior