man7.org > Linux > man-pages

Linux/UNIX system programming training

form_field_attributes(3x) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | PORTABILITY | AUTHORS | SEE ALSO | COLOPHON 

form_field_attributes(3X)     Library calls     form_field_attributes(3X)

NAME         top

       form_field_attributes - color and attribute control for form
       fields

SYNOPSIS         top

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

DESCRIPTION         top

       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         top

       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         top

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

AUTHORS         top

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

SEE ALSO         top

       curses(3X) and related pages whose names begin “form_” for
       detailed descriptions of the entry points.

COLOPHON         top

       This page is part of the ncurses (new curses) project.
       Information about the project can be found at 
       ⟨https://invisible-island.net/ncurses/ncurses.html⟩.  If you have a
       bug report for this manual page, send it to bug-ncurses@gnu.org.
       This page was obtained from the tarball ncurses-6.6.tar.gz fetched
       from ⟨https://ftp.gnu.org/gnu/ncurses/⟩ on 2026-01-16.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

ncurses @NCURSES_MAJOR@.@NCU... 2024-03-16      form_field_attributes(3X)

HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI