field_attributes(3form)

field_attributes3form

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

18 releases since Debian 1.1 (Buzz); the text changed 12 times.

  1. 1.1–1.3
  2. 2.0
  3. 2.1
  4. 2.2
  5. 3.0
  6. 3.1
  7. 4.0
  8. 5.0–6.0
  9. 7–9
  10. 10
  11. 11
  12. 12
  13. 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.