Technical Reference: Base Operating System and Extensions, Volume 2

standend, standout, wstandend, or wstandout Subroutine

Purpose

Sets and clears window attributes.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int standend
(void);

int standout
(void);

int wstandend
(WINDOW *win);

int wstandout
(WINDOW *win);

Description

The standend and standout subroutines turn off all attributes of the current or specified window.

The wstandout and wstandend subroutines turn on the standout attribute of the current or specified window.

Parameters

Return Values

These subroutines always return 1.

Examples

1. To turn on the standout attribute in the stdscr, enter:

   standout();

   This example is functionally equivalent to:

   attron(A_STANDOUT);

2. To turn on the standout attribute in the user-defined window my_window, enter:

   WINDOW *my_window;
   wstandout(my_window);

   This example is functionally equivalent to:

   wattron(my_window, A_STANDOUT);

3. To turn off the standout attribute in the default window, enter:

   standend();

   This example is functionally equivalent to:

   attroff(A_STANDOUT);

4. To turn off the standout attribute in the user-defined window my_window, enter:

   WINDOW *my_window;
   wstandend(my_window);

   This example is functionally equivalent to:

   wattroff(my_window, A_STANDOUT);

Related Information

The attroff, attron, or wattroff (attroff, attron, attrset, wattroff, wattron, or wattrset Subroutine) subroutines.

Curses Overview for Programming, List of Curses Subroutines, Manipulating Video Attributes in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.