field_back(3)

field_back3

Color and attribute control for form fields

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

66 releases since FreeBSD 4.3-RELEASE; the text changed 6 times.

  1. 4.3–4.11
  2. 5.0–6.2
  3. 6.3–10.4
  4. 11.0–12.4
  5. 13.0–13.5
  6. 14.0–14.1
  7. 14.2–16.0

Authors

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

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.