field_back(3form)

field_back3form

Color and attribute control for form fields

Part of field_attributes(3form).

Usage

#include <form.h>

int set_field_fore(FIELD *field, chtype attr); chtype field_fore(const FIELD *field);

int set_field_back(FIELD *field, chtype attr); chtype field_back(const FIELD *field);

int set_field_pad(FIELD *field, int pad); int field_pad(const FIELD *field);

Overview

The function set_field_fore sets the foreground attribute of field. This is the highlight used to display the field contents. The function field_fore returns the foreground attribute. The default is A_STANDOUT.

The function set_field_back sets the background attribute of form. This is the highlight used to display the extent fields in the form. The function field_back returns the background attribute. The default is A_NORMAL.

The function set_field_pad sets the character used to fill the field. The function field_pad returns the given form's pad character. The default is a blank.

Return value

These routines return one of the following:

E_OK

The routine succeeded.

E_BAD_ARGUMENT

Routine detected an incorrect or out-of-range argument.

E_SYSTEM_ERROR

System error occurred (see errno(3)).

Portability

These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions.

Releases

12 releases since Debian 3.0 (Woody); the text changed 8 times.

  1. 3.0
  2. 3.1
  3. 4.0
  4. 5.0–6.0
  5. 7–9
  6. 10
  7. 11
  8. 12
  9. 13

Authors

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond.

From ncurses-doc 6.5+20250216-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.