WMENU_EVENTREAD(3W)

Series 300 and 500 Only

NAME

wmenu_eventread − read the menu event

SYNOPSIS

#include <window.h>
wmenu_eventread (fd, menuid, itemno)
int fd;
int *menuid;
int *itemno;

DESCRIPTION

fd is an integer file descriptor for an opened window type device interface.

menuid
id of the menu from which an item was selected.

itemno
id of the item selected; -1 indicates the menu was somehow aborted.

DISCUSSION

This routine returns menu event data. It’s the responsibility of the application to sort menu event data by menuid. A return value of 0 indicates that no menu event data was available from fd. A return value of greater than 0 indicates the number of queued menu data events the first of which contained is returned in menuid and itemno.

This routine is typically used in conjunction with notification by SIGWINDOW and weventpoll(3W) that a menu event has happened. The EVENT_MENU bit (see window.h) is used with wsetsigmask(3W).

DIAGNOSTICS

A return of -1 indicates failure; otherwise the number of queued menu data events is returned. See errno(2) for further information.

Hewlett-Packard Company — May 11, 2021

Museum