This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

glutMenuStatusFunc(3GLUT)                           GLUT                           glutMenuStatusFunc(3GLUT)



NAME
       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 function.

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 indicate 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 callbacks) 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 callback
       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 current window will be set to the  win-dow window
       dow from which the initial 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 glutMenuStatusFunc routine. The only difference is
       glutMenuStateFunc callback prototype does not deliver the two additional x and y coordinates.

SEE ALSO
       glutCreateMenu(3G), glutCreateWindow(3G)


AUTHOR
       Mark J. Kilgard (mjk@nvidia.com)



GLUT                                                 3.7                           glutMenuStatusFunc(3GLUT)