Technical Reference: Base Operating System and Extensions , Volume 2

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

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The doupdate (doupdate, refresh, wnoutrefresh, or wrefresh Subroutines) subroutine, getsyx (getsyx Subroutine) subroutine, leaveok (leaveok Subroutine) subroutine, wnoutrefresh (doupdate, refresh, wnoutrefresh, or wrefresh Subroutines) subroutine.

Controlling the Cursor with Curses in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

Curses Overview for Programming and List of Curses Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.