mitem_current man page on MirBSD

Man page or keyword search:  
man Server   6113 pages
apropos Keyword Search (all sections)
Output format
MirBSD logo
[printable version]



mitem_current(3)    UNIX Programmer's Manual	 mitem_current(3)

NAME
     mitem_current - set and get current_menu_item

SYNOPSIS
     #include <menu.h>
     int set_current_item(MENU *menu, const 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).  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.

RETURN VALUE
     current_item returns NULL on error.

     top_row and item_index return ERR (the general curses error
     value) on error.

     set_current_item and set_top_row return one of the follow-
     ing:

     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_STATE
	  Routine was called from an initialization or termina-
	  tion function.

     E_NOT_CONNECTED
	  No items are connected to the menu.

SEE ALSO
     curses(3), menu(3).

MirOS BSD #10-current	Printed 18.8.2011			1

mitem_current(3)    UNIX Programmer's Manual	 mitem_current(3)

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.

MirOS BSD #10-current	Printed 18.8.2011			2

[top]

List of man pages available for MirBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net