X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_field_new.3x.html;h=d97791aabe7bc6b70df8adbc7fb78d35c1c00a2f;hp=4c8e1d482e1e0b23b882bd0dd9e17267b2730273;hb=9f479192e3ca3413d235c66bf058f8cc63764898;hpb=a8987e73ec254703634802b4f7ee30d3a485524d diff --git a/doc/html/man/form_field_new.3x.html b/doc/html/man/form_field_new.3x.html index 4c8e1d48..d97791aa 100644 --- a/doc/html/man/form_field_new.3x.html +++ b/doc/html/man/form_field_new.3x.html @@ -1,8 +1,8 @@ - - + -form_field_new 3x - + + +form_field_new 3X + -

form_field_new 3x

-
+

form_field_new 3X

-
-form_field_new(3x)                             form_field_new(3x)
+form_field_new(3X)                                          form_field_new(3X)
 
 
 
 
-
-

NAME

-       form_field_new - create and destroy form fields
+

NAME

+       new_field,  dup_field, link_field, free_field - create and destroy form
+       fields
 
 
-
-

SYNOPSIS

-       #include <form.h>
-       FIELD *new_field(int height, int width,
-                        int toprow, int leftcol,
-                        int offscreen, int nbuffers);
-       FIELD *dup_field(FIELD *field, int toprow, int leftcol);
-       FIELD *link_field(FIELD *field, int toprow, int leftcol);
-       int free_field(FIELD *field);
+

SYNOPSIS

+       #include <form.h>
 
+       FIELD *new_field(int height, int width,
+                        int toprow, int leftcol,
+                        int offscreen, int nbuffers);
+       FIELD *dup_field(FIELD *field, int toprow, int leftcol);
+       FIELD *link_field(FIELD *field, int toprow, int leftcol);
+       int free_field(FIELD *field);
 
-
-

DESCRIPTION

-       The  function new_field allocates a new field and initial-
-       izes it from the parameters given: height, width,  row  of
-       upper-left  corner,  column  of  upper-left corner, number
-       off-screen rows, and number of additional working buffers.
 
-       The  function  dup_field duplicates a field at a new loca-
-       tion.  Most attributes (including current contents,  size,
-       validation  type, buffer count, growth threshold, justifi-
-       cation, foreground, background,  pad  character,  options,
-       and  user pointer) are copied.  Field status and the field
-       page bit are not copied.
+

DESCRIPTION

+       The function new_field allocates a new field and  initializes  it  from
+       the  parameters  given: height, width, row of upper-left corner, column
+       of upper-left corner, number off-screen rows, and number of  additional
+       working buffers.
 
-       The function link_field acts like dup_field, but  the  new
-       field  shares  buffers with its parent.  Attribute data is
-       separate.
+       The  function  dup_field  duplicates  a  field at a new location.  Most
+       attributes (including current contents, size, validation  type,  buffer
+       count,  growth  threshold,  justification,  foreground, background, pad
+       character, options, and user pointer) are copied.  Field status and the
+       field page bit are not copied.
 
-       The function free_field  de-allocates  storage  associated
-       with a field.
+       The  function  link_field acts like dup_field, but the new field shares
+       buffers with its parent.  Attribute data is separate.
 
+       The function free_field de-allocates storage associated with a field.
 
-
-

RETURN VALUE

-       The function, new_field, dup_field, link_field return NULL
-       on error.
 
-       The function free_field returns one of the following:
+

RETURN VALUE

+       The functions new_field, dup_field, link_field return  NULL  on  error.
+       They set errno according to their success:
 
-       E_OK The routine succeeded.
+       E_OK The routine succeeded.
 
-       E_SYSTEM_ERROR
-            System error occurred (see errno).
+       E_BAD_ARGUMENT
+            Routine detected an incorrect or out-of-range argument.
 
-       E_BAD_ARGUMENT
-            Routine detected an incorrect or  out-of-range  argu-
-            ment.
+       E_SYSTEM_ERROR
+            System error occurred, e.g., malloc failure.
 
+       The function free_field returns one of the following:
 
-
-

SEE ALSO

-       curses(3x), form(3x).
+       E_OK The routine succeeded.
 
+       E_BAD_ARGUMENT
+            Routine detected an incorrect or out-of-range argument.
 
-
-

NOTES

-       The header file <form.h> automatically includes the header
-       file <curses.h>.
+       E_CONNECTED
+            field is connected.
 
 
-
-

PORTABILITY

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

SEE ALSO

+       curses(3X), form(3X).
 
-       It  may be unwise to count on the set of attributes copied
-       by  dup_field(3x)  being  portable;  the  System  V  forms
-       library  documents  are  not very explicit about what gets
-       copied and what doesn't.
 
+

NOTES

+       The  header  file  <form.h>  automatically  includes  the  header  file
+       <curses.h>.
 
-
-

AUTHORS

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

PORTABILITY

+       These routines emulate the System  V  forms  library.   They  were  not
+       supported on Version 7 or BSD versions.
+
+       It  may be unwise to count on the set of attributes copied by dup_field
+       being portable; the System V  forms  library  documents  are  not  very
+       explicit about what gets copied and what does not.
+
+
+

AUTHORS

+       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
+       Raymond.
 
 
 
-                                               form_field_new(3x)
+                                                            form_field_new(3X)
-
-
-Man(1) output converted with -man2html -
+
+ +