1form_field_attributes(3CURSECSu)rses Library Functiofnosrm_field_attributes(3CURSES)
2
3
4

NAME

6       form_field_attributes,   set_field_fore,   field_fore,  set_field_back,
7       field_back, set_field_pad,  field_pad  -  format  the  general  display
8       attributes of forms
9

SYNOPSIS

11       cc [ flag... ] file... -lform  -lcurses  [ library... ]
12       #include <form.h>
13
14       int set_field_fore(FIELD *field, chtype attr);
15
16
17       chtype field_fore(FIELD *field);
18
19
20       int set_field_back(FIELD *field, chtype attr);
21
22
23       chtype field_back(FIELD *field);
24
25
26       int set_field_pad(FIELD *field, int pad);
27
28
29       int field_pad(FIELD *field);
30
31

DESCRIPTION

33       set_field_fore() sets the foreground attribute of field. The foreground
34       attribute is the low-level curses display attribute used to display the
35       field contents. field_fore() returns the foreground attribute of field.
36
37
38       set_field_back() sets the background attribute of field. The background
39       attribute is the low-level curses display attribute used to display the
40       extent  of  the field. field_back() returns the background attribute of
41       field.
42
43
44       set_field_pad() sets the pad character of field to pad. The pad charac‐
45       ter is the character used to fill within the field. field_pad() returns
46       the pad character of field.
47

RETURN VALUES

49       field_fore(), field_back(), and field_pad() return  default  values  if
50       field  is  NULL. If field is not NULL and is not a valid FIELD pointer,
51       the return value from these routines is undefined.
52
53
54       set_field_fore(), set_field_back(), and set_field_pad() return  one  of
55       the following:
56
57       E_OK              The function returned successfully.
58
59
60       E_SYSTEM_ERROR    System error.
61
62
63       E_BAD_ARGUMENT    An argument is incorrect.
64
65

ATTRIBUTES

67       See attributes(5) for descriptions of the following attributes:
68
69
70
71
72       ┌─────────────────────────────┬─────────────────────────────┐
73       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │MT-Level                     │Unsafe                       │
76       └─────────────────────────────┴─────────────────────────────┘
77

SEE ALSO

79       curses(3CURSES), forms(3CURSES), attributes(5)
80

NOTES

82       The  header  <form.h>  automatically  includes the headers  <eti.h> and
83       <curses.h>.
84
85
86
87SunOS 5.11                        31 Dec 1996   form_field_attributes(3CURSES)