====== CURSOR Property ======


 
==== Applies To ====
 
All controls.
 
==== Description ====
 
Returns or sets the cursor to be used when a control has focus.
 
==== Usage ====
 
cursor = Get_Property(objectname,”CURSOR”)

existingCursor = Set_Property(objectname,”CURSOR”, cursorValue)
 
 
==== Remarks ====
 
Values passed in Set_Property():

^Value^Description^
|cursorValue|The cursorValue parameter may be:\\ \\ - A standard windows cursor.\\ - A cursor file name.\\ - A cursor resource in a DLL.|

 

1) Standard Windows Cursors

"A" - Arrow

"H" - Hourglass

"I" - I-Beam

"C" - Cross

"V" - Vertical Arrow

"&" - Hand

"S" - App Starting

"?" - Help

"N" - No

"+" - Size All

"\" - Size NWSE

"/" - Size NESW

"-" - Size WE

"" - Size NS

2) A cursor file name:

e.g.  ".\cursors\myCursor.cur"

3) A cursor resource in a DLL

e.g. "myreslib.dll#123" or "myreslib.dll#mycursor"

 

 

 

 
 
==== Returns ====
 
Values returned by Get_Property and Set_Property

^Value^Description^
|cursor|the Boolean status of the control’s rowshade.|
|existingState|the Boolean status of the control’s rowshade, when Set_Property was run.|
 
==== See Also ====
 
[[set_property|Set_Property() function]], [[get_property|Get_Property() function]]
 
==== Example ====
 
<code>
Declare function Get_Property, Set_Property

 

/* This snippet of code will check the current SYSTEM cursor and if it is an Hourglass will change the cursor to an Arrow.

*/

 

cursor = Get_Property("SYSTEM","CURSOR")

if cursor _Eqc "H" then

  eCursor = Set_Property("SYSTEM","CURSOR","A")

end
</code>