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

Item Description
*win Specifies the window in which to set the attributes.

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