WAUTOTOP(3W)

NAME

wautotop − autotop a window

SYNOPSIS

#include <window.h>
int wautotop (fd, value)
int fd;
int value;

DESCRIPTION

fd is an integer file descriptor for an opened term0 window type device interface.

value is an integer which determines what action the routine should take.

DISCUSSION

This call inquires or sets whether the window will automatically become top most upon output to its device interface. This routine does not work with graphics window types.

If value is -1, the current autotop state is returned. A 1 value returned indicates that the window indicated by this file descriptor is currently autotop while a 0 value returned indicates that it is not.

If value is 0, then the window is not moved to the top upon output. This is the default state at window create time.

If value is 1, then the window is automatically moved to the top when output is sent to its device interface (special file). If the window is currently in an iconic state, it will become normal the next time output is directed to the window.

Note that the autotop attribute is turned off after output is sent to a window. Therefore, to automatically top a window every time output is sent to it, be sure to call wautotop whenever output is sent to the window.

DIAGNOSTICS

A value of 0 or 1 is returned unless autotop does not apply or fd does not refer to a window, in which case -1 is returned. See errno(2) for further information.