menuhook(3X) menuhook(3X)

NAME
       mmeennuuhhooookk - set hooks for automatic invocation by applications

SYNOPSIS
       ##iinncclluuddee <>
       int setiteminit(MENU *menu, void (*func)(MENU *));
       void (*)(MENU *) iteminit(const MENU *menu);
       int setitemterm(MENU *menu, void (*func)(MENU *));
       void (*)(MENU *) itemterm(const MENU *menu);
       int setmenuinit(MENU *menu, void (*func)(MENU *));
       void (*)(MENU *) menuinit(const MENU *menu);
       int setmenuterm(MENU *menu, void (*func)(MENU *));
       void (*)(MENU *) menuterm(const MENU *menu);

DESCRIPTION
       These  functions make it possible to set hook functions to be called at
       various points in the automatic processing  of  input  event  codes  by
       mmeennuuddrriivveerr.

       The  function  sseettiitteemmiinniitt sets a hook to be called at menu-post time
       and each time the selected item changes (after the change).   iitteemmiinniitt
       returns  the  current  item init hook, if any (NNUULLLL if there is no such
       hook).

       The function sseettiitteemmtteerrmm sets a hook to be called at menu-unpost time
       and each time the selected item changes (before the change).  iitteemmtteerrmm
       returns the current item term hook, if any (NNUULLLL if there  is  no  such
       hook).

       The  function  sseettmmeennuuiinniitt sets a hook to be called at menu-post time
       and just after the top row on the  menu  changes  once  it  is  posted.
       mmeennuuiinniitt  returns the current menu init hook, if any (NNUULLLL if there is
       no such hook).

       The function sseettmmeennuutteerrmm sets a hook to be called at menu-unpost time
       and  just  before  the  top  row on the menu changes once it is posted.
       mmeennuutteerrmm returns the current menu term hook, if any (NNUULLLL if there  is
       no such hook).

RREETTUURRNN VVAALLUUEE
       Routines  that  return  pointers  return NNUULLLL on error.  Other routines
       return one of the following:

       EEOOKK The routine succeeded.

       EESSYYSSTTEEMMEERRRROORR
            System error occurred (see eerrrrnnoo).

SEE ALSO
       ccuurrsseess(3X), mmeennuu(3X).

NNOOTTEESS
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PPOORRTTAABBIILLIITTYY
       These  routines  emulate the System V menu library.  They were not sup-
       ported on Version 7 or BSD versions.

AUTHORS       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                 menuhook(3X)