glutMenuStatusFunc - sets the global menu status callback.

SYNTAX

       void glutMenuStatusFunc(void (*func)(int status, int x, int y));
       void glutMenuStateFunc(void (*func)(int status));

ARGUMENTS

       func      The new menu status (or  state)  callback  func-
                 tion.

DESCRIPTION

       glutMenuStatusFunc sets the global menu status callback so
       a GLUT program can determine when a menu is in use or not.
       When  a  menu  status  callback  is registered, it will be
       called with  the  value  GLUT_MENU_IN_USE  for  its  value
       parameter  when  pop-up  menus are in use by the user; and
       the   callback   will   be   called   with    the    value
       GLUT_MENU_NOT_IN_USE  for its status parameter when pop-up
       menus are no longer in use. The x and y  parameters  indi-
       cate  the  location  in  window  coordinates of the button
       press that caused the menu to go into use, or the location
       where  the  menu was released (may be outside the window).
       The func parameter  names  the  callback  function.  Other
       callbacks  continue  to operate (except mouse motion call-
       backs) when pop-up menus are in use  so  the  menu  status
       callback  allows  a  program to suspend animation or other
       tasks when menus are in use. The cascading  and  unmapping
       of sub-menus from an initial pop-up menu does not generate
       menu status callbacks. There is a single menu status call-
       back for GLUT.

       When  the menu status callback is called, the current menu
       will be set  to  the  initial  pop-up  menu  in  both  the
       GLUT_MENU_IN_USE  and GLUT_MENU_NOT_IN_USE cases. The cur-
       rent window will be set to the window from which the  ini-
       tial menu was popped up from, also in both cases.

       Passing NULL to glutMenuStatusFunc disables the generation
       of the menu status callback.

       glutMenuStateFunc is a deprecated  version  of  the  glut-
       MenuStatusFunc  routine. The only difference is glutMenuS-
       tateFunc callback prototype does not deliver the two addi-
       tional x and y coordinates.

SEE ALSO

       glutCreateMenu, glutCreateWindow

AUTHOR

       Mark J. Kilgard (mjk@nvidia.com)