Home
Search all pages
Subjects
By activity
Professions, Sciences, Humanities, Business, ...
User Interface
Text-based, GUI, Audio, Video, Keyboards, Mouse, Images,...
Text Strings
Conversions, tests, processing, manipulation,...
Math
Integer, Floating point, Matrix, Statistics, Boolean, ...
Processing
Algorithms, Memory, Process control, Debugging, ...
Stored Data
Data storage, Integrity, Encryption, Compression, ...
Communications
Networks, protocols, Interprocess, Remote, Client Server, ...
Hard World Timing, Calendar and Clock, Audio, Video, Printer, Controls...
File System
Management, Filtering, File & Directory access, Viewers, ...
|
|
|
RocketLink!--> Man page versions:
OpenBSD
mitem_current(3) 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). 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
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 argu-
ment.
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).
1
mitem_current(3) 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.
2
Source: OpenBSD 2.6 man pages. Copyright: Portions are copyrighted by BERKELEY SOFTWARE DESIGN, INC., The Regents of the University of California, Massachusetts Institute of Technology, Free Software Foundation, FreeBSD Inc., and others. |
(Corrections, notes, and links courtesy of RocketAware.com)
OpenBSD sources for mitem_current(3)
Up to: Curses menus - Curses (Library for text display interface) on screen menus
RocketLink!--> Man page versions:
OpenBSD
Rapid-Links:
Search | About | Comments | Submit Path: RocketAware > man pages >
mitem_current.3/
RocketAware.com is a service of Mib Software Copyright 1999, Forrest J. Cavalier III. All Rights Reserved. We welcome submissions and comments
|