setsyx Subroutine

Purpose

Sets the coordinates of the virtual screen cursor.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

setsyx( Y, X) int Y, X;

Description

The setsyx subroutine sets the coordinates of the virtual screen cursor to the specified row and column coordinates. If Y and X are both -1, then the leaveok flag is set. (leaveok may be set by applications that do not use the cursor.)

The setsyx subroutine is intended for use in combination with the getsyx subroutine. These subroutines should be used by a user-defined function that manipulates curses windows but wants the position of the cursor to remain the same. Such a function would do the following:

Call the getsyx subroutine to obtain the current virtual cursor coordinates.
Continue processing the windows.
Call the wnoutrefresh subroutine on each window manipulated.
Call the setsyx subroutine to reset the current virtual cursor coordinates to the original values.
Refresh the display by calling the doupdate subroutine.

Parameters

Item	Description
X	Specifies the column to set the virtual screen cursor to.
Y	Specifies the row to set the virtual screen cursor to.