bkgdset man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

bkgd(3XCURSES)		X/Open Curses Library Functions		bkgd(3XCURSES)

NAME
       bkgd,  bkgdset,	getbkgd,  wbkgd,  wbkgdset - set or get the background
       character (and rendition) of window

SYNOPSIS
       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library... ]

       #include <curses.h>

       int bkgd(chtype ch);

       void bkgdset(chtype ch);

       chtype getbkgd(WINDOW *win);

       int wbkgd(WINDOW *win, chtype ch);

       void wbkgdset(WINDOW *win, chtype ch);

DESCRIPTION
       The bkgdset() and wbkgdset() functions turn off the previous background
       attributes,  logical OR the requested attributes into the window rendi‐
       tion, and set the background property of the current or specified  win‐
       dow  based  on  the  information	 in ch. If ch refers to a multi-column
       character, the results are undefined.

       The bkgd() and wbkgd()  functions  turn	off  the  previous  background
       attributes,  logical OR the requested attributes into the window rendi‐
       tion, and set the background property of the current or specified  win‐
       dow  and	 then  apply  this setting to every character position in that
       window:

	 ·  The rendition of every character on the screen is changed  to  the
	    new window rendition.

	 ·  Wherever the former background character appears, it is changed to
	    the new background character.

       The getbkgd() function extracts the specified window's background char‐
       acter and rendition.

PARAMETERS
       ch	Is the background character to be set.

       win	Is  a  pointer to the window in which the background character
		is to  be set.

RETURN VALUES
       Upon successful completion, the bkgd() and wbkgd() functions return OK.
       Otherwise, they return ERR.

       The bkgdset() and wbkgdset() functions do not return a value.

       Upon  successful	 completion, the getbkgd() function returns the speci‐
       fied window's background character and rendition. Otherwise, it returns
       (chtype)ERR.

ERRORS
       No errors are defined.

USAGE
       These  functions	 are  only guaranteed to operate reliably on character
       sets in which each character fits into a single byte, whose  attributes
       can be expressed using only constants with the A_ prefix.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Unsafe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       addch(3XCURSES),		addchstr(3XCURSES),	    attroff(3XCURSES),
       bkgrnd(3XCURSES),    clear(3XCURSES),	clrtoeol(3XCURSES),	clrto‐
       bot(3XCURSES),  erase(3XCURSES),	 inch(3XCURSES),  libcurses(3XCURSES),
       mvprintw(3XCURSES), attributes(5), standards(5)

SunOS 5.10			  5 Jun 2002			bkgd(3XCURSES)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net