Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

< Previous PageNext Page > Hide TOC

Standard Cursors

Table 12-1 shows the standard cursors and explains when to use each. The “API information” column gives the constants to implement them in Carbon or Cocoa.

Table 12-1  Standard cursors in Mac OS X

Cursor

Use

API information

image: ../art/cu_arrowcursor.gif

Menu bar, desktop, scroll bar, resize control, title bar, close button, zoom button, minimize button, other controls.

Carbon: kThemeArrowCursor

Cocoa:arrowCursor

image: ../art/cu_contextualmenu.gif

Indicates the user can open a contextual menu for an item. Shown when the user presses the Control key while the cursor is over an object with a contextual menu.

Carbon:kThemeContextualMenuArrowCursor

Cocoa: Not available

image: ../art/cu_alias.gif

Indicates the drag destination will have an alias for the original object (the original object will not be moved).

Carbon:kThemeAliasArrowCursor

Cocoa: Not available

image: ../art/cu_poof.gif

Indicates that the proxy object being dragged will go away, without deleting the original object, if the mouse button is released. Used only for proxy objects.

Carbon:kThemePoofCursor

Cocoa:disappearingItemCursor

image: ../art/cu_copy.gif

Indicates that the drag destination will have a copy of the original object (the original object will not be moved).

Carbon:kThemeCopyArrowCursor

Cocoa: Not available

image: ../art/cu_no_entry.gif

Indicates an invalid drag destination.

Carbon:kThemeNotAllowedCursor

Cocoa: Not available

image: ../art/cu_ibeamcursor.gif

Selecting and inserting text.

Carbon:kThemeIBeamCursor

Cocoa:IBeamCursor

image: ../art/cu_crosshair_hi_res.gif

Precise rectangular selection, especially useful for graphics objects.

Carbon:kThemeCrossCursor

Cocoa:crosshairCursor

image: ../art/cu_pointing_hand.gif

URL links.

Carbon:kThemePointingHandCursor

Cocoa:pointingHandCursor

image: ../art/cu_open_hand.gif

Indicates that an item can be manipulated within its containing view.

Carbon:kThemeOpenHandCursor

Cocoa:openHandCursor

image: ../art/cu_closedhand.gif

Pushing, sliding, or adjusting an object within a containing view.

Carbon:kThemeClosedHandCursor

Cocoa:closedHandCursor

image: ../art/cu_move_left.gif

Moving or resizing an object, usually a pane splitter, to the left. Use when the user can move the object only in the indicated direction.

Carbon:kThemeResizeLeftCursor

Cocoa:resizeLeftCursor

image: ../art/cu_move_right.gif

Moving or resizing an object, usually a pane splitter, to the right. Use when the user can move the object only in the indicated direction.

Carbon:kThemeResizeRightCursor

Cocoa:resizeRightCursor

image: ../art/cu_move_left_and_right.gif

Moving or resizing an object, usually a pane splitter, to the left or the right.

Carbon:kThemeResizeLeftRightCursor

Cocoa:resizeLeftRightCursor

image: ../art/cu_move_up.gif

Moving or resizing an object, usually a pane splitter, upward. Use when the user can move the object only in the indicated direction.

Carbon:kThemeResizeUpCursor

Cocoa:resizeUpCursor

image: ../art/cu_move_down.gif

Moving or resizing an object, usually a pane splitter, downward. Use when the user can move the object only in the indicated direction.

Carbon:kThemeResizeDownCursor

Cocoa:resizeDownCursor

image: ../art/cu_moveupanddown.gif

Moving or resizing an object, usually a pane splitter, either upward or downward.

Carbon:kThemeResizeUpDownCursor

Cocoa:resizeUpDownCursor

The spinning wait cursor (see Figure 12-1) is displayed automatically by the window server when an application cannot handle all of the events it receives. If an application does not respond for about 2 to 4 seconds, the spinning wait cursor appears. You should try to avoid situations in your application in which the spinning wait cursor will be displayed. The Spin Control application provided with Xcode can help you eliminate code that is causing this cursor.


Figure 12-1  Spinning wait cursor

Spinning wait cursor



< Previous PageNext Page > Hide TOC


Last updated: 2008-06-09




Did this document help you?
Yes: Tell us what works for you.

It’s good, but: Report typos, inaccuracies, and so forth.

It wasn’t helpful: Tell us what would have helped.
Get information on Apple products.
Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Copyright © 2007 Apple Inc.
All rights reserved. | Terms of use | Privacy Notice