X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fmenu_opts.3x;h=99e950e5b8d495ef6bf657f7d36f69e9097884e2;hp=dc927c47700ca4fc0ecc161abae1643181cb4008;hb=14d46fadc442db9df4567357cda396235418120e;hpb=b6d7123594f6959ad0a6602b3952d9e6abe261a0 diff --git a/man/menu_opts.3x b/man/menu_opts.3x index dc927c47..99e950e5 100644 --- a/man/menu_opts.3x +++ b/man/menu_opts.3x @@ -1,6 +1,7 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998-2006,2007 Free Software Foundation, Inc. * +.\" Copyright 2018-2019,2020 Thomas E. Dickey * +.\" Copyright 1998-2015,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,20 +28,23 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_opts.3x,v 1.10 2007/02/24 17:33:59 tom Exp $ +.\" $Id: menu_opts.3x,v 1.18 2020/10/17 23:46:35 tom Exp $ .TH menu_opts 3X "" .SH NAME -\fBmenu_opts\fR - set and get menu options +\fBset_menu_opts\fP, +\fBmenu_opts_on\fP, +\fBmenu_opts_off\fP, +\fBmenu_opts\fR \- set and get menu options .SH SYNOPSIS \fB#include \fR +.sp +\fBint set_menu_opts(MENU *\fP\fImenu\fP\fB, Menu_Options \fP\fIopts\fP\fB);\fP .br -int set_menu_opts(MENU *menu, Menu_Options opts); +\fBMenu_Options menu_opts(const MENU *\fP\fImenu\fP\fB);\fP +.sp +\fBint menu_opts_on(MENU *\fP\fImenu\fP\fB, Menu_Options \fP\fIopts\fP\fB);\fP .br -int menu_opts_on(MENU *menu, Menu_Options opts); -.br -int menu_opts_off(MENU *menu, Menu_Options opts); -.br -Menu_Options menu_opts(const MENU *menu); +\fBint menu_opts_off(MENU *\fP\fImenu\fP\fB, Menu_Options \fP\fIopts\fP\fB);\fP .br .SH DESCRIPTION The function \fBset_menu_opts\fR sets all the given menu's option bits (menu @@ -74,6 +78,12 @@ Move the cursor to within the item name while pattern-matching. O_NONCYCLIC Don't wrap around next-item and previous-item, requests to the other end of the menu. +.TP 5 +O_MOUSE_MENU +If user clicks with the mouse +and it does not fall on the currently active menu, +push \fBKEY_MOUSE\fP and the \fBMEVENT\fP data +back on the queue to allow processing in another part of the calling program. .SH RETURN VALUE Except for \fBmenu_opts\fR, each routine returns one of the following: .TP 5 @@ -81,7 +91,7 @@ Except for \fBmenu_opts\fR, each routine returns one of the following: The routine succeeded. .TP 5 .B E_SYSTEM_ERROR -System error occurred (see \fBerrno\fR). +System error occurred (see \fBerrno\fR(3)). .TP 5 .B E_POSTED The menu is already posted. @@ -91,14 +101,9 @@ The menu is already posted. The header file \fB\fR automatically includes the header file \fB\fR. .SH PORTABILITY -These routines emulate the System V menu library. They were not supported on +These routines emulate the System V menu library. +They were not supported on Version 7 or BSD versions. .SH AUTHORS -Juergen Pfeifer. Manual pages and adaptation for new curses by Eric -S. Raymond. -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: +Juergen Pfeifer. +Manual pages and adaptation for new curses by Eric S. Raymond.