CURSOR

nameID CURSOR [load-option] [mem-option] filename

The CURSOR statement specifies a bitmap that defines the shape of the cursor on the display screen.

Parameters

nameID

Specifies either a unique name or an integer identifying the resource.

load-option

Specifies when the resource is to be loaded. The parameter must be one of the following:

Option Description

PRELOAD Resource is loaded immediately.
LOADONCALL Resource is loaded when called. This is the default option.

mem-option

Specifies whether the resource is fixed or movable and whether it is discardable. The parameter must be one of the following:

Option Description

FIXED Resource remains at a fixed memory location.
MOVEABLE Resource can be moved if necessary in order to compact memory.
DISCARDABLE Resource can be discarded if no longer needed.

The default is MOVEABLE and DISCARDABLE for cursor, icon, and font resources. The default for bitmap resources is MOVEABLE.

filename

Specifies the name of the file that contains the resource. The name must be a valid MS-DOS filename; it must be a full path if the file is not in the current working directory. The path can either be a quoted or non-quoted string.

Comments

Icon and cursor resources can contain more than one image. If the resource is marked with the PRELOAD option, Windows loads all images in the resource when the application executes.

Examples

The following example specifies two cursor resources; one by name (cursor1) and the other by number (2):

cursor1 CURSOR bullseye.cur
2       CURSOR "d:\\cursor\\arrow.cur"