Error getting tags :
error 404Error getting tags :
error 404 cursor | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
cursor
Basics
Expander triangle
Type
Property
Syntax

set the cursor to {cursorName | imageID}

Introduced
1.0
Changed
3.5
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Specifies the shape of the cursor.
Examples

set the cursor to watch
set the cursor to arrow
set the cursor to 21403

Additional Comments
Expander triangle

Use the cursor property to signal the status of a handler to the user or to indicate what kind of data the mouse pointer is over. For example, a watch cursor shows the user that a handler is executing, while an I-beam cursor indicates that the text under the mouse pointer is editable.

Value:

The cursor is the ID of an image to use for a cursor.

Revolution looks for the specified image in the following order:

1) The stack of the current object's behavior (if applicable)

2) The stack of the owner of the current object's behavior (if applicable)

...

n) The stack of the current object's stack's behavior (if applicable)

A) The current object's stack

B) The current object's stack's mainstack (if a substack)

C) The current object's stack's mainstacks substacks

D) The list of open stacks, in order they were loaded

Revolution includes several built-in cursors whose names you can use in place of their image IDs.

Comments:

The built-in cursors and their recommended uses are:

* none: Hides the cursor

* busy: Use repeatedly during a long handler

* watch: Use during a moderately long handler

* arrow: Use for selecting objects

* cross: Use for painting, drawing, or selecting a point or small area

* hand: Use for clicking hypertext links

* iBeam: Use for selecting text in a field

* plus: Use for selecting items such as spreadsheet cells

* help: Use for getting online help

The busy cursor is a rotating beach ball. Each time you use the statement set the cursor to busy, the beach ball advances in its rotation. For example, the following statements cause the cursor to appear to spin as long as the repeat loop is running:

repeat until someCondition is true

set the cursor to busy -- spins a bit further

doSomething -- insert whatever you want the loop to do here

end repeat

You can also set the cursor property to the ID of an image. Custom cursor images must contain three colors: black, white, and a transparent color.

Cross-platform note: To be used as a cursor on Mac OS systems, an image must be 16x16 pixels. To be used as a cursor on Unix or Windows systems, an image must be 16x16 or 32x32 pixels.

If the lockCursor property is set to false, Revolution automatically sets the cursor according to its location once the handler finishes. (For example, the cursor normally turns into an arrow over a menu, an I-beam over an editable text field, and so on.) To retain the cursor property after a handler finishes, use the lock cursor command.

You can force Revolution to use the operating system's cursors with the following two statements:

delete stack "revCursors"

reset cursors

Caution! If you use the delete stack command to remove the "revCursors" stack, Revolution's cursors are permanently deleted and you will need to download a new cursors stack to restore them.

If you change the set of built-in Revolution cursors in the "revCursors" stack, you must either quit and restart the application or use the reset cursors command to begin using the new cursor shapes.

Changes to Revolution:

The order in which Revolution searches for cursors was changed in version 3.5. Previously, the current stack was searched first, followed by the list of open stacks.

User Comments
Expander triangle
User thumbnail
stephen@networkxfla.com
StarStarStarStarStar
May 9, 2009
A cleaer example:
set the lockCursor to true set the cursor to hand
-- locking the cursor gives *you* control of the cursor from the system. So that you can set the icon.
set the lockCursor to false
-- returns the cursor back to the system.