mvwin Subroutine

Purpose

Moves a window or subwindow to the specified coordinates.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int mvwin
(WINDOW *win,
int y,
int x);

Description

The mvwin subroutine moves the specified window so that its origin is at position (y, x). If the move causes any portion of the window to extend past any edge of the screen, the function fails and the window is not moved.

Parameters

Return Values

Upon successful completion, the mvwin subroutine returns OK. Otherwise, it returns ERR.

Examples

1. To move the user-defined window my_window from its present location to the upper left corner of the terminal, enter:

   WINDOW *my_window;
   mvwin(my_window, 0, 0);

2. To move the user-defined window my_window from its present location to the coordinates y = 20, x = 10, enter:

   WINDOW *my_window;
   mvwin(my_window, 20, 10);