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);

Implementation Specifics

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

Related Information

The derwin subroutine, doupdate subroutine, is_linetouched subroutine.

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Manipulating Window Data with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.