cursor

Usage

-- Lingo syntax
spriteObjRef.cursor

// JavaScript syntax
spriteObjRef.cursor;

Description

Sprite property; determines the cursor used when the pointer is over a sprite. Read/write.

This property stays in effect until you turn it off by setting the cursor to 0. Use the cursor property to change the cursor when the mouse pointer is over specific regions of the screen and to indicate regions where certain actions are possible when the user clicks on them.

When you set the cursor property in a given frame, Director keeps track of the sprite rectangle to determine whether to alter the cursor. This rectangle persists when the movie enters another frame unless you set the cursor property for that channel to 0.

• Use the following syntax to specify the number of a cast member to use as a cursor and its optional mask.

  -- Lingo syntax
  spriteObjRef.cursor = [castMemberObjRef, maskCastMemberObjRef]
  
  // JavaScript syntax
  spriteObjRef.cursor = [castMemberObjRef, maskCastMemberObjRef];
  

• Use the following syntax to specify default system cursors.

  -- Lingo syntax
  spriteObjRef.cursor = castMemberObjRef
  
  // JavaScript syntax
  spriteObjRef.cursor = castMemberObjRef;
  

The cursor property can be set to one of the following integer values:

To use custom cursors, set the cursor property to a list containing the cast member to be used as a cursor or to the number that specifies a system cursor. In Windows, a cursor must be a cast member, not a resource; if a cursor is not available because it is a resource, Director displays the standard arrow cursor instead. For best results, don't use custom cursors when creating cross-platform movies.

Custom cursor cast members must be no larger than 16 by 16 pixels, and must be 1-bit in depth.

If the sprite is a bitmap that has matte ink applied, the cursor changes only when the cursor is over the matte portion of the sprite.

When the cursor is over the location of a sprite that has been removed, rollover still occurs. Avoid this problem by not performing rollovers at these locations or by relocating the sprite up above the menu bar before deleting it.

On the Macintosh, you can use a numbered cursor resource in the current open movie file as the cursor by setting cursor to the number of the cursor resource.

Example

This statement changes the cursor that appears over sprite 20 to a watch (Macintosh) or hourglass (Windows) cursor.

-- Lingo syntax
sprite(20).cursor = 4

// JavaScript syntax
sprite(20).cursor = 4;

See also

Sprite