Futurebasic/Language/Reference/cursor

= CURSOR statement =

Statement
✔ χ Appearance ✔ χ Standard ✔ χ Console

Syntax (Standard BASIC):

Syntax (Appearance Runtime)
Revised: February, 2002 (Release 6)

Description
If  is positive, it's interpreted as the resource ID of a ' ' (first choice) or a ' ' resource (alternative choice), and this statement changes the current cursor to the indicated cursor. The following cursor resources are found in the System file, and are always available:

For Appearance Manager calls,  must be   or

Standard BASIC:

    

Appearance manager Cursors Items marked with an asterisk (*) may be animated.

           <img src="c/cursor11a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16"> <img src="c/cursor09a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16"> <img src="c/cursor11a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16"> <img src="c/cursor14a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16"> <img src="c/cursor15a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16"> <img src="c/cursor16a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16"> <img src="c/cursor17a.gif" alt="IMAGE imgs/CURSOR_statement02.gif" height="16" width="16">

Error Messages (Appearance Manager) <b> </b>If you attempt to use an illegal value in the cursor statement, you will see the following dialog:

<img src="c/CURSOR_statement07.gif" alt="" height="132" width="375" border="0">

This type of dialog will only appear when you select Run from the Command menu. It will not show up if you use an illegal value in the program after selecting Build. This prevents the error message from appearing on your end user's screen, but still makes it available during the coding process.

Forcing a Cursor Event: <b> </b>If  is negative(for example: then the cursor is changed to the one whose ID is , and a cursor event is generated, which can be trapped by checking for events of type   with the  function. You cannot generate a   when switching to the   (since its resource ID number has no negative!)

Note: If you've designed a  or a   resource of your own which you want to make available to your program, do the following:

<ol> <li>Assign a positive resource ID number to the resource (don't use any of the numbers in the above table. You should use an ID number of 128 or higher.)

<li>Copy the resource to the resources file which you reference in your program's  statement.

</ol>

You can then use the  statement to activate your cursor within the program.