CURPUT

Purpose:

Sets the cursor location to a specified x-axis location.

Syntax:

CURPUT(win, xvalue, cursor, item)

win

-

Optional. Window reference. Defaults to the current Window.

xvalue

-

A real number. The x-value for desired cursor location.

cursor

-

Optional. A positive integer. The index of the column cursor in the item. Defaults to 1, the first cursor.

item

-

Optional. A positive integer. The index to the item in the Window. Defaults to 1.

Example:

W1: integ(gnorm(1000, 1/100));curput(5.0)

a = curloc(w1)

 

W1 contains a 1000 point series and the first cursor is set to X location 5.0, sample index 501. Variable a contains the value 5.0.

Example:

W1: gnorm(1000, 1/10)

W2: W1

 

curput(w1, 30.0);curput(w1, 50.0, 2);

curxextract(w1, w2);

 

W1 contains a 1000 point series and W2 contains a copy of W1. The first cursor of W1 is set to X location 30.0 and the second cursor is set to location 50.0. W2 then extracts the region from 30.0 to 50.0 of its original data resulting in a 201 point series.

Remarks:

If the index implied by the xvalue is less than one, then the cursor will be set to one. If the index implied by the xvalue is greater than the number of points in the item, then the cursor will be set to the number of points in the item.

 

See CURLOC to return the cursor X location.

 

See CURPOS to set the cursor position based on the sample index.

See Also:

COLNMOVE

COLNPUT

COLPOS

CURLOC

CURMOVE

CURNMOVE

CURNPUT

CURPOS

CURSORON