Resources for specifying cursor appearance

The following resources control the appearance of the xdt3 cursor under various circumstances. The default cursors are built into the Desktop, but any of them can be redefined.

Each type of cursor has a data and mask pixmap component associated with it. Together, these components form a cursor shape. The data pixmap defines the image associated with the cursor and the mask pixmap defines the shape upon which the data pixmap is drawn. To modify a cursor's appearance, you must specify both a data and a mask pixmap for the cursor. If only one pixmap is specified, the resource is ignored.

The first element in each cursor resource specification indicates the type of cursor that you want to define. The different cursors are defined as follows:

alert

when an alert box is displayed (except within the text entry field)

bgTrigger

when a user clicks on the background

busy

when xdt3 is processing

drag

when a single icon is being dragged

fatal

when an error box is displayed (except within the box)

iconTrigger

when a user clicks on an icon to select it

idle

when xdt3 is waiting for the user to perform a task

multiDrag

when more than one icon is being dragged

rubber

when a user is using ``rubberbanding'' to select one or more icons

Cursor appearance resources

Data pixmap
Mask pixmap		Name	Class	File	Name
Class	File
alert.data	Cursor.Bitmap	explode_d.xbm	alert.mask	Cursor.Bitmap	explode_m.xbm
bgTrigger.data	Cursor.Bitmap	grip_d.xbm	bgTrigger.mask	Cursor.Bitmap	grip_m.xbm
busy.data	Cursor.Bitmap	wait_d.xbm	busy.mask	Cursor.Bitmap	wait_m.xbm
drag.data	Cursor.Bitmap	drag_d.xbm	drag.mask	Cursor.Bitmap	drag_d.xbm
fatal.data	Cursor.Bitmap	fatal_d.xbm	fatal.mask	Cursor.Bitmap	fatal_m.xbm
iconTrigger.data	Cursor.Bitmap	grip_d.xbm	iconTrigger.mask	Cursor.Bitmap	grip_m.xbm
idle.data	Cursor.Bitmap	press_d.xbm	idle.mask	Cursor.Bitmap	press_m.xbm
multiDrag.data	Cursor.Bitmap	mdrag_d.xbm	multiDrag.mask	Cursor.Bitmap	mdrag_m.xbm
rubber.data	Cursor.Bitmap	grip_d.xbm	rubber.data	Cursor.Bitmap	grip_m.xbm

All resources listed in ``Cursor appearance resources'' accept filenames as values. Unless an absolute pathname is specified, the default picture directory, as defined by the pictureDirectory resource, is searched for the specified file. To change the default picture directory, see ``Resources for changing default rule files and directories''. Pixmap files specify icon dimensions in pixels; no default values are assigned.

See ``Changing cursor appearance'' for more information on specifying the resources described in this section.