<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html
  PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN" "http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd">
<html
	xmlns="http://www.w3.org/1999/xhtml"
	xmlns:mml="http://www.w3.org/1998/Math/MathML"
><head><title>glutMenuStatusFunc</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.59.1"/><link rel="home" href="index.xml" title="PyOpenGL 2.0.1.07 Man Pages"/><link rel="up" href="reference-GLUT.xml" title="GLUT"/><link rel="previous" href="glutMainLoop.3GLUT.xml" title="glutMainLoop"/><link rel="next" href="glutMotionFunc.3GLUT.xml" title="glutMotionFunc"/></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">glutMenuStatusFunc</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="glutMainLoop.3GLUT.xml">Prev</a> </td><th width="60%" align="center">GLUT</th><td width="20%" align="right"> <a accesskey="n" href="glutMotionFunc.3GLUT.xml">Next</a></td></tr></table><hr/></div><div class="refentry" lang="en"><a name="glutMenuStatusFunc.3GLUT"/><div class="titlepage"/><div class="refnamediv"><a name="glutMenuStatusFunc.3GLUT-name"/><h2>Name</h2><p>glutMenuStatusFunc &#8212; sets the global menu status callback.</p></div><div class="refsynopsisdiv"><a name="glutMenuStatusFunc.3GLUT-c_spec"/><h2>C Specification</h2><table class="funcprototype" border="0" cellpadding="0" cellspacing="0"><tr><td valign="top"><code>void <tt>glutMenuStatusFunc</tt></code></td><td valign="top"><code>(</code></td><td valign="top"><code>void (*<i><tt>func</tt></i>)(int status, int x, int y));</code></td></tr><tr><td valign="top"><code>void <tt>glutMenuStateFunc</tt></code></td><td valign="top"><code>(</code></td><td valign="top"><code>void (*<i><tt>func</tt></i>)(int status));</code></td></tr></table></div><div class="refsynopsisdiv"><a name="glutMenuStatusFunc.3GLUT-python_spec"/><h2>Python Specification</h2><table class="funcprototype" border="0" cellpadding="0" cellspacing="0"><tr><td valign="top"><code><tt>glutMenuStatusFunc</tt></code></td><td valign="top"><code>(</code></td><td valign="top"><code><i><tt>func</tt></i>) &#8594; <tt>None</tt></code></td></tr><tr><td valign="top"><code><tt>glutMenuStateFunc</tt></code></td><td valign="top"><code>(</code></td><td valign="top"><code><i><tt>func</tt></i>) &#8594; <tt>None</tt></code></td></tr></table></div><div class="refsect1" lang="en"><a name="glutMenuStatusFunc.3GLUT-parameters"/><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><i><tt>func</tt></i></span></dt><dd>
						The new menu status (or state) callback function.
					</dd></dl></div></div><div class="refsect1" lang="en"><a name="glutMenuStatusFunc.3GLUT-description"/><h2>Description</h2><p>
			<tt>glutMenuStatusFunc</tt> 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
			<tt>GLUT_MENU_IN_USE</tt> for its value parameter when pop-up menus are in use by the user; and the
			callback will be called with the value <tt>GLUT_MENU_NOT_IN_USE</tt> for its status parameter when pop-up
			menus are no longer in use. The <i><tt>x</tt></i> and <i><tt>y</tt></i> 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 callback for GLUT.
		</p><p>
			When the menu status callback is called, the current menu will be set to the initial pop-up menu in both the
			<tt>GLUT_MENU_IN_USE</tt> and <tt>GLUT_MENU_NOT_IN_USE</tt> cases. The current window will be
			set to the window from which the initial menu was popped up from, also in both cases.
		</p><p>
			Passing <tt>NULL</tt> to <tt>glutMenuStatusFunc</tt> disables the generation of the menu status
			callback. <tt>glutMenuStateFunc</tt> is a deprecated version of the
			<tt>glutMenuStatusFunc</tt> routine. The only difference is <tt>glutMenuStateFunc</tt> callback prototype does not deliver the two additional x and y
			coordinates.
		</p></div><div class="refsect1" lang="en"><a name="glutMenuStatusFunc.3GLUT-see_also"/><h2>See Also</h2><p>
			<span class="simplelist"><a href="glutCreateMenu.3GLUT.xml">glutCreateMenu</a>, <a href="glutCreateWindow.3GLUT.xml">glutCreateWindow</a></span>
		</p></div></div><div class="navfooter"><hr/><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="glutMainLoop.3GLUT.xml">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="reference-GLUT.xml">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="glutMotionFunc.3GLUT.xml">Next</a></td></tr><tr><td width="40%" align="left" valign="top">glutMainLoop </td><td width="20%" align="center"><a accesskey="h" href="index.xml">Home</a></td><td width="40%" align="right" valign="top"> glutMotionFunc</td></tr></table></div></body></html>
