X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmitem_current.3x.html;h=77f2616838578b63cce1b91ca20ee5a983a9c48e;hp=82614bbd2bd5effbb37786ca44f3bb857a179b42;hb=a90dd7b66fa711acd24d8181ea20e4f57d4b36cd;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01 diff --git a/doc/html/man/mitem_current.3x.html b/doc/html/man/mitem_current.3x.html index 82614bbd..77f26168 100644 --- a/doc/html/man/mitem_current.3x.html +++ b/doc/html/man/mitem_current.3x.html @@ -1,8 +1,8 @@ - + + + mitem_current 3x - + -

mitem_current 3x

-
+

mitem_current 3x

-
+mitem_current(3x)                                            mitem_current(3x)
 
-
-

NAME

+
+
+
+

NAME

        mitem_current - set and get current_menu_item
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #include <menu.h>
-       int set_current_item(MENU *menu, const ITEM *item);
+       int set_current_item(MENU *menu, ITEM *item);
        ITEM *current_item(const MENU *menu);
        int set_top_row(MENU *menu, int row);
        int top_row(const MENU *menu);
        int item_index(const ITEM *item);
 
 
-
-

DESCRIPTION

-       The  function  set_current_item sets the current item (the
-       item on  which  the  menu  cursor  is  positioned).   cur-
-       rent_item  returns  a  pointer  to the current item in the
-       given menu.
-
-       The function set_top_row sets the top row of the  menu  to
-       show  the  given  row  (the top row is initially 0, and is
-       reset to this value whenever the O_ROWMAJOR option is tog-
-       gled).   The  item  leftmost on the given row becomes cur-
-       rent.  The function top_row returns the number of the  top
+

DESCRIPTION

+       The  function set_current_item sets the current item (the item on which
+       the menu cursor is positioned).  current_item returns a pointer to  the
+       current item in the given menu.
+
+       The function set_top_row sets the top row of the menu to show the given
+       row (the top row is initially 0, and is reset to  this  value  whenever
+       the  O_ROWMAJOR option is toggled).  The item leftmost on the given row
+       becomes current.  The function top_row returns the number  of  the  top
        menu row being displayed.
 
-       The function item_index returns the (zero-origin) index of
-       item in the menu's item pointer list.
+       The  function item_index returns the (zero-origin) index of item in the
+       menu's item pointer list.
 
 
-
-

RETURN VALUE

-       current_item returns NULL on error.
+

RETURN VALUE

+       current_item returns a pointer (which may be NULL).  It  does  not  set
+       errno.
 
-       top_row and item_index  return  ERR  (the  general  curses
-       error value) on error.
+       top_row  and  item_index return ERR (the general curses error value) if
+       their menu parameter is NULL.
 
-       set_current_item and set_top_row return one of the follow-
-       ing:
+       set_current_item and set_top_row return one of the following:
 
        E_OK The routine succeeded.
 
-       E_SYSTEM_ERROR
-            System error occurred (see errno).
-
        E_BAD_ARGUMENT
-            Routine detected an incorrect or  out-of-range  argu-
-            ment.
+            Routine detected an incorrect or out-of-range argument.
 
        E_BAD_STATE
-            Routine was called from an initialization or termina-
-            tion function.
+            Routine was called from an initialization or termination function.
 
        E_NOT_CONNECTED
             No items are connected to the menu.
 
-
-
-

SEE ALSO

-       curses(3x), menu(3x).
-
-
-
-

NOTES

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

PORTABILITY

-       These  routines  emulate  the System V menu library.  They
-       were not supported on Version 7 or BSD versions.
-
-       The SVr4 menu library documentation specifies the  top_row
-       and  index_item  error  value as -1 (which is the value of
-       ERR).
-
-
-
-

AUTHORS

-       Juergen Pfeifer.  Manual  pages  and  adaptation  for  new
-       curses by Eric S. Raymond.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+       E_SYSTEM_ERROR
+            System error occurred (see errno(3)).
 
 
+

SEE ALSO

+       curses(3x), menu(3x).
 
 
+

NOTES

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

PORTABILITY

+       These  routines  emulate the System V menu library.  They were not sup-
+       ported on Version 7 or BSD versions.
 
+       The  SVr4  menu  library  documentation  specifies  the   top_row   and
+       index_item error value as -1 (which is the value of ERR).
 
 
+

AUTHORS

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