WAUTOSELECT(3W)

NAME

wautoselect − autoselect a window

SYNOPSIS

#include <window.h>
int wautoselect (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 will take.

DISCUSSION

This call inquires or sets, depending on the value parameter, whether the term0 window will automatically become selected when output is sent to its device interface. This routine does not work with graphics windows.

If value is -1, then the current autoselect status is returned. A 1 value returned indicates that the window denoted by this file descriptor is currently autoselect while a 0 value returned indicates that it is not.

Setting value to 0 will turn off autoselect−the window won’t automatically be selected when output is sent to its device interface. This is the default state at window create time.

Setting value to 1 causes the window to become selected automatically upon output to its device interface.

Sending output to a window that has auto-selection enabled has an additional side effect: it turns auto-selection off. Therefore, to automatically select a window when output is sent to it, call wautoselect whenever output is sent to the window.

DIAGNOSTICS

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