X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_field.3x.html;h=3faa99656e01f30488f23a87ee0a3fd768f29eec;hp=2f14eafb5a65708568536f6ad158ce64b325bb7d;hb=761e4f0825b330e970558e82a4bd638383914429;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;ds=sidebyside diff --git a/doc/html/man/form_field.3x.html b/doc/html/man/form_field.3x.html index 2f14eafb..3faa9965 100644 --- a/doc/html/man/form_field.3x.html +++ b/doc/html/man/form_field.3x.html @@ -1,17 +1,60 @@ + + +
++form_field(3x) form_field(3x) + + +
- form_field - make and break connections between fields and + form_field - make and break connections between fields and forms
- #include <form.h> + #include <form.h> int set_form_fields(FORM *form, FIELD **fields); FIELD **form_fields(const FORM *form); int field_count(const FORM *form); @@ -20,64 +63,65 @@
- The function set_form_fields changes the field pointer - array of the given form. The array must be terminated by - a NULL. + The function set_form_fields changes the field pointer + array of the given form. The array must be terminated by + a NULL. - The function form_fields returns the field array of the + The function form_fields returns the field array of the given form. - The function field_count returns the count of fields in - form. + The function field_count returns the count of fields in + form. - The function move_field move the given field (which must + The function move_field moves the given field (which must be disconnected) to a specified location on the screen.-
- The function form_fields returns NULL on error. +RETURN VALUE
+ The function form_fields returns a pointer (which may be + NULL). It does not set errno. - The function field_count returns ERR (the general curses - error return value) on error. + The function field_count returns ERR if the form parameter + is NULL. - The functions set_form_fields and move_field return one of + The functions set_form_fields and move_field return one of the following codes on error: - E_OK The routine succeeded. - - E_SYSTEM_ERROR - System error occurred (see errno). + E_OK The routine succeeded. - E_BAD_ARGUMENT - Routine detected an incorrect or out-of-range argu- + E_BAD_ARGUMENT + Routine detected an incorrect or out-of-range argu- ment. - E_POSTED + E_CONNECTED + The field is already connected to a form. + + E_POSTED The form is already posted. - E_CONNECTED - The field is already connected to a form. + E_SYSTEM_ERROR + System error occurred (see errno).SEE ALSO
- curses(3x), form(3x). + curses(3x), form(3x).NOTES
- The header file <form.h> automatically includes the header - file <curses.h>. + The header file <form.h> automatically includes the header + file <curses.h>.PORTABILITY
- These routines emulate the System V forms library. They + These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions. - The SVr4 forms library documentation specifies the - field_count error value as -1 (which is the value of ERR). + The SVr4 forms library documentation specifies the + field_count error value as -1 (which is the value of ERR).@@ -87,45 +131,7 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + form_field(3x)