Purpose

Establishes a default cursor for the window.

Syntax

winio@('%dc[cursor_name]')
winio@('%`dc', const)
integer(7) const     (input)
winio@('%Ndc[name1][name2] . . .[nameN]',sel)
winio@('%`Ndc', const1, const2, . . . , constN, sel)
integer sel, const1, const2, . . . , constN     (input)

Modifiers

Grave accent (`) - cursor is specified by using a ClearWin+ parameter from windows.ins.

Description

cursor_name is a standard character string (can be replaced by @) used to identify a cursor via a resource script.

The alternative uses a grave accent modifier together with const which is one of:

CURSOR_ARROW

Standard arrow cursor

CURSOR_IBEAM

Text I-beam cursor

CURSOR_WAIT

Hourglass cursor

CURSOR_CROSS

Cross hair cursor

CURSOR_UPARROW

Vertical arrow cursor

CURSOR_SIZE

A square with a smaller square inside its lower-right corner

CURSOR_ICON

Empty icon

CURSOR_SIZENWSE

Double-pointed cursor with arrows pointing Northwest and Southeast

CURSOR_SIZENESW

Double-pointed cursor with arrows pointing Northeast and Southwest

CURSOR_SIZEWE

Double-pointed cursor with arrows pointing west and east

CURSOR_SIZENS

Double-pointed cursor with arrows pointing North and South

Another pair of alternatives uses a positive integer N to provide a selection of N different cursors. In this case the variable sel is given a value in the range 1 .. N in order to specify a particular cursor. It is not necessary to call WINDOW_UPDATE@ when sel is changed. The examples below illustrate the first pair of alternatives.

cursor_name can also take the form of an integer handle surrounded by curly brackets (integer kind=7) or the name of an external file surrounded by curly brackets.

Example

	winio@('%dc[mycursor]')
	mycursor CURSOR file.cur      (resource file)
	winio@('%`dc',CURSOR_IBEAM)
					

See also

%cu (Cursor)