Link Search Menu Expand Document
KLCV DEV MANUAL

DisplayObject.SetCursor Method

Explanation Set the mouse cursor.

The mouse cursor that can be specified with the SetCursor method is standard Windows mouse pointer data with a .cur or .ani extension.
Since the mouse cursor is changed immediately by calling the method, it is possible to change the mouse cursor before the time-consuming process and return it after the process is completed.

In an object tree starting with "//" (Root object), if the mouse cursor is set in multiple hierarchies with the SetCursor method, the higher setting takes precedence. For example, if you execute the SetCursor method on both a Form object and a Button object placed as a child of it, the specified cursor will be displayed on the Form object even if the mouse cursor moves over the Button object.

Call the ResetCursor method to return the set mouse cursor to standard.

Mouse cursors may have restrictions on the formats available depending on the display hardware. For example, one display can only use a monochrome two-tone mouse cursor. For applications that may run on older computers, make sure to use the mouse cursor in a format that is available on the intended computer.

Mobile version
Shows the weight cursor. It takes an argument to maintain compatibility with the PC version, but the argument is not used.

Also, unlike the PC version, each object is not distinguished. Calling this method from any object will have similar results.

To stop displaying the wait cursor, call the ResetCursor method.

Android version
Display the wait dialog. The wait dialog is always displayed in the center of the screen and you cannot perform any other operations while it is displayed.

Also, as with the Mobile version, no distinction is made for each object. Calling this method from any object will have similar results.

To stop displaying the wait dialog, call the ResetCursor method.

Added since Ver.4.1.0, Mobile Ver.3.0.0, AI Ver.1.0.1
Call format PC, Mobile version
obj.SetCursor( URL or reader )
Android version
obj.SetCursor( [ message [, title ]] )
Return value None
Arguments URL or reader Specify the URL or Reader object to get the cursor data.

When specifying the URL, you can specify it with a relative path or an absolute path, and the cursor data is downloaded and displayed.
Only when the URL is specified, it will be cached.

Mobile version
Any value
String message Specify the character string of the message part of the wait dialog.
If omitted, "Please wait" is displayed.
If an empty string is specified, no message is displayed.
String title The character string in the title part of the weight dialog.
If omitted, "Processing" is displayed.
If an empty string is specified, the title will not be displayed.
Exception PKG-57 Cannot setCursor or ResetCursor on array definition
PKG-58 Unable to get cursor data
PKG-59 Invalid argument
PKG-60 Unable to create temporary file
PKG-61 Invalid cursor data
Example of use 
Function OnTouch(e) {
    //.SetCursor("wait.cur");
    :
    //.ResetCursor();
}
Related item ResetCursor method