<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>gtkmm 2.4: Gtk::Main Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="#ffffff">
<table border="0" width="100%">
<tr>
<td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
<td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
</tr>
</table>
<center>
<a class="qindex" href="../../index.html">Main Page</a>
<a href="group__Widgets.html">Widgets</a>
<a class="qindex" href="namespaces.html"> Namespaces</a>
<a href="../../tutorial/html/index.html"> Book</a>
</center>
<hr width="100%"/>
<!-- begin main content -->
<div id="content">
<!-- Generated by Doxygen 1.5.1 -->
<div class="nav">
<a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1Main.html">Main</a></div>
<h1>Gtk::Main Class Reference</h1><!-- doxytag: class="Gtk::Main" --><!-- doxytag: inherits="sigc::trackable" -->Inheritance diagram for Gtk::Main:<p><center><img src="classGtk_1_1Main__inherit__graph.png" border="0" usemap="#Gtk_1_1Main__inherit__map" alt="Inheritance graph"></center>
<map name="Gtk_1_1Main__inherit__map">
<area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classsigc_1_1trackable.html" shape="rect" coords="5,6,117,33" alt="">
</map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classGtk_1_1Main-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
<a class="el" href="classGtk_1_1Main.html">Main</a> application class Every application must have one of these objects.
<p>
It may not be global and must be the first <a class="el" href="namespaceGtk.html">Gtk</a> object created. It is a singleton so declaring more than one will simply access the first created.<p>
Normal use of this class is in the main() function to give argc and argv to the gtk initialization. Widgets can use <a class="el" href="classGtk_1_1Main.html#8719a8ac37ff6bb66048ca8967dbd782">Gtk::Main::quit()</a> to exit from the application.<p>
The internals of the widget have been disguised as signals so that the user can easily connect using the same methods used throughout the widget interface.<p>
Minimal gtkmm application is something like this: <div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> main(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> *argv[]) {
<a class="code" href="classGtk_1_1Main.html">Gtk::Main</a> kit(argc, argv);
... create some widgets ...
kit.run();
}
</pre></div>
<p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#2b7340ad84fe8d66bb7489c635e8fd5e">Main</a> (int& argc, char**& argv, bool set_locale=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">See <a class="el" href="classGtk_1_1Main.html#e02744d26abd4abfe106ed31f05ad2dc">Main(int* argc, char*** argv, bool set_locale)</a>. <a href="#2b7340ad84fe8d66bb7489c635e8fd5e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#e02744d26abd4abfe106ed31f05ad2dc">Main</a> (int* argc, char*** argv, bool set_locale=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Scans the argument vector, and strips off all parameters known to GTK+. <a href="#e02744d26abd4abfe106ed31f05ad2dc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#fbc89daf89de698660ce02426967e135">Main</a> (int& argc, char**& argv, <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a>& option_context)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Scans the argument vector, and strips off all parameters parsed by GTK+ or your <em>option_context</em>. <a href="#fbc89daf89de698660ce02426967e135"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#485eeb37361615a021ca21fb2a6f257c">~Main</a> ()</td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#16e384f8b3a02af8d3e86f59053b218e">add_gtk_option_group</a> (<a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a>& option_context, bool open_default_display=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add a <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionGroup.html">Glib::OptionGroup</a>, for the commandline arguments recognized by GTK+ and GDK, to a <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a>, so that these commandline arguments will be processed in addition to the existing commandline arguments specified by the <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a>. <a href="#16e384f8b3a02af8d3e86f59053b218e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#2a2a6cddef82f8c52026790f3f7887e0">events_pending</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if any events are pending. <a href="#2a2a6cddef82f8c52026790f3f7887e0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#ab3b3f72ad21e91e4c644ee5131d4058">init_gtkmm_internals</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classGtk_1_1Main.html">Gtk::Main</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#94b74eb618f4b0d213c79c2ada927446">instance</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Access to the one global instance of <a class="el" href="classGtk_1_1Main.html">Gtk::Main</a>. <a href="#94b74eb618f4b0d213c79c2ada927446"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#b9ba7993ef8a22b6bf8796a2e4862e68">iteration</a> (bool blocking=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Runs a single iteration of the main loop. <a href="#b9ba7993ef8a22b6bf8796a2e4862e68"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static guint </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#78f66b89dbe811cdce075a8b00c8987a">level</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#8719a8ac37ff6bb66048ca8967dbd782">quit</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Makes the innermost invocation of the main loop return when it regains control. <a href="#8719a8ac37ff6bb66048ca8967dbd782"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#aa2e4e282834cbe2d789fe34c447a0dd">run</a> (<a class="el" href="classGtk_1_1Window.html">Window</a>& window)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns from the main loop when the window is closed. <a href="#aa2e4e282834cbe2d789fe34c447a0dd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#6a8904c35952006d13cb07c1d0c16c10">run</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Start the event loop. <a href="#6a8904c35952006d13cb07c1d0c16c10"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static KeySnooperSig& </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#b4c316c0789dfb4ab7926e062196c4e5">signal_key_snooper</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">KeySnooper signal Allows you to channel keypresses to a signal handler without registering with the widget. <a href="#b4c316c0789dfb4ab7926e062196c4e5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static QuitSig& </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#c1b6ae5b79cb84158f3caf3e9382492d">signal_quit</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Quit signal You can connect signal handlers to invoke actions when <a class="el" href="classGtk_1_1Main.html#8719a8ac37ff6bb66048ca8967dbd782">Gtk::Main::quit()</a> has been called. <a href="#c1b6ae5b79cb84158f3caf3e9382492d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static RunSig& </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#ec1562f7b2a23858472aa94d23b66173">signal_run</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Run signal. <a href="#ec1562f7b2a23858472aa94d23b66173"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#4a8ca03d685b708e9dc38e3ddaa0875a">events_pending_impl</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#6f855eae235b700e2242fb68252dcea5">init</a> (int* argc, char*** argv, bool set_locale)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#681a82f7118d71188e64ba9379bb33e7">iteration_impl</a> (bool blocking)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual guint </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#ad90e366d331016ce5ff68023f214d8b">level_impl</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#8a5748d38300e0484a8cf7c756af8c99">Main</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#7c3bb918c54342b71e9e56d999b4dd4e">on_window_hide</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#785e09dce370a1c5260885ced9efb4a6">quit_impl</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#2642c570bde971015f97b97cce743f80">run_impl</a> ()</td></tr>
<tr><td colspan="2"><br><h2>Static Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static KeySnooperSig </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#97582880bbb0ac12e957861a7ed165a3">signal_key_snooper_</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static QuitSig </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#ee8ba380608053d85a98847eaeb564da">signal_quit_</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static RunSig </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Main.html#459e2ec96368ff1c28f351496c3200d6">signal_run_</a></td></tr>
</table>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="fbc89daf89de698660ce02426967e135"></a><!-- doxytag: member="Gtk::Main::Main" ref="fbc89daf89de698660ce02426967e135" args="(int &argc, char **&argv, Glib::OptionContext &option_context)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Main::Main </td>
<td>(</td>
<td class="paramtype">int & </td>
<td class="paramname"> <em>argc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char **& </td>
<td class="paramname"> <em>argv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a> & </td>
<td class="paramname"> <em>option_context</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Scans the argument vector, and strips off all parameters parsed by GTK+ or your <em>option_context</em>.
<p>
Add a <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionGroup.html">Glib::OptionGroup</a> to the <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a> to parse your own command-line arguments.<p>
Note: The argument strings themself won't be modified, although the pointers to them might change. This makes it possible to create your own argv of string literals, which have the type 'const char[]' in standard C++. (You might need to use const_cast<>, though.)<p>
This function automatically generates nicely formatted <option>--help</option> output. Note that your program will be terminated after writing out the help output.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>argc</em> </td><td>a reference to the number of command line arguments. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>argv</em> </td><td>a reference to the array of command line arguments. a string which is displayed in the first line of <option>--help</option> output, after <literal><replaceable>programname</replaceable> [OPTION...]</literal> </td></tr>
<tr><td valign="top"></td><td valign="top"><em>option_context</em> </td><td>A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a> containing Glib::OptionGroups which described the command-line arguments taken by your program.</td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionError.html">Glib::OptionError</a></em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="e02744d26abd4abfe106ed31f05ad2dc"></a><!-- doxytag: member="Gtk::Main::Main" ref="e02744d26abd4abfe106ed31f05ad2dc" args="(int *argc, char ***argv, bool set_locale=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Main::Main </td>
<td>(</td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>argc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *** </td>
<td class="paramname"> <em>argv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>set_locale</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Scans the argument vector, and strips off all parameters known to GTK+.
<p>
Your application may then handle the remaining arguments.<p>
Note: The argument strings themself won't be modified, although the pointers to them might change. This makes it possible to create your own argv of string literals, which have the type 'const char[]' in standard C++. (You might need to use const_cast<>, though.)
</div>
</div><p>
<a class="anchor" name="2b7340ad84fe8d66bb7489c635e8fd5e"></a><!-- doxytag: member="Gtk::Main::Main" ref="2b7340ad84fe8d66bb7489c635e8fd5e" args="(int &argc, char **&argv, bool set_locale=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Main::Main </td>
<td>(</td>
<td class="paramtype">int & </td>
<td class="paramname"> <em>argc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char **& </td>
<td class="paramname"> <em>argv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>set_locale</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
See <a class="el" href="classGtk_1_1Main.html#e02744d26abd4abfe106ed31f05ad2dc">Main(int* argc, char*** argv, bool set_locale)</a>.
<p>
</div>
</div><p>
<a class="anchor" name="485eeb37361615a021ca21fb2a6f257c"></a><!-- doxytag: member="Gtk::Main::~Main" ref="485eeb37361615a021ca21fb2a6f257c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gtk::Main::~Main </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="8a5748d38300e0484a8cf7c756af8c99"></a><!-- doxytag: member="Gtk::Main::Main" ref="8a5748d38300e0484a8cf7c756af8c99" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Main::Main </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="16e384f8b3a02af8d3e86f59053b218e"></a><!-- doxytag: member="Gtk::Main::add_gtk_option_group" ref="16e384f8b3a02af8d3e86f59053b218e" args="(Glib::OptionContext &option_context, bool open_default_display=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gtk::Main::add_gtk_option_group </td>
<td>(</td>
<td class="paramtype"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a> & </td>
<td class="paramname"> <em>option_context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>open_default_display</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionGroup.html">Glib::OptionGroup</a>, for the commandline arguments recognized by GTK+ and GDK, to a <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a>, so that these commandline arguments will be processed in addition to the existing commandline arguments specified by the <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a>.
<p>
You do not need to use this method if you pass your <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1OptionContext.html">Glib::OptionContext</a> to the <a class="el" href="classGtk_1_1Main.html">Main</a> constructor, because it adds the gtk option group automatically.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>option_context</em> </td><td>Option Context to which the group will be added. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>open_default_display</em> </td><td>Whether to open the default display when parsing the commandline arguments. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="2a2a6cddef82f8c52026790f3f7887e0"></a><!-- doxytag: member="Gtk::Main::events_pending" ref="2a2a6cddef82f8c52026790f3f7887e0" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gtk::Main::events_pending </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Checks if any events are pending.
<p>
This can be used to update the GUI and invoke timeouts etc. while doing some time intensive computation.<p>
Example: Updating the GUI during a long computation. <div class="fragment"><pre class="fragment"> <span class="comment">// computation going on</span>
<span class="keywordflow">while</span>( <a class="code" href="classGtk_1_1Main.html#2a2a6cddef82f8c52026790f3f7887e0">Gtk::Main::events_pending</a>() )
<a class="code" href="classGtk_1_1Main.html#b9ba7993ef8a22b6bf8796a2e4862e68">Gtk::Main::iteration</a>();
<span class="comment">// computation continued</span>
</pre></div><p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if any events are pending, false otherwise. </dd></dl>
</div>
</div><p>
<a class="anchor" name="4a8ca03d685b708e9dc38e3ddaa0875a"></a><!-- doxytag: member="Gtk::Main::events_pending_impl" ref="4a8ca03d685b708e9dc38e3ddaa0875a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool Gtk::Main::events_pending_impl </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="6f855eae235b700e2242fb68252dcea5"></a><!-- doxytag: member="Gtk::Main::init" ref="6f855eae235b700e2242fb68252dcea5" args="(int *argc, char ***argv, bool set_locale)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Main::init </td>
<td>(</td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>argc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *** </td>
<td class="paramname"> <em>argv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>set_locale</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="ab3b3f72ad21e91e4c644ee5131d4058"></a><!-- doxytag: member="Gtk::Main::init_gtkmm_internals" ref="ab3b3f72ad21e91e4c644ee5131d4058" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gtk::Main::init_gtkmm_internals </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="94b74eb618f4b0d213c79c2ada927446"></a><!-- doxytag: member="Gtk::Main::instance" ref="94b74eb618f4b0d213c79c2ada927446" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classGtk_1_1Main.html">Gtk::Main</a>* Gtk::Main::instance </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Access to the one global instance of <a class="el" href="classGtk_1_1Main.html">Gtk::Main</a>.
<p>
</div>
</div><p>
<a class="anchor" name="b9ba7993ef8a22b6bf8796a2e4862e68"></a><!-- doxytag: member="Gtk::Main::iteration" ref="b9ba7993ef8a22b6bf8796a2e4862e68" args="(bool blocking=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gtk::Main::iteration </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>blocking</em> = <code>true</code> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Runs a single iteration of the main loop.
<p>
If no events are waiting to be processed GTK+ will block until the next event is noticed. If you don't want to block then pass false for <em>blocking</em> or check if any events are pending with pending() first.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>blocking</em> </td><td>Whether the caller must wait until the next event is noticed, or return immediately if there are no events. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if <a class="el" href="classGtk_1_1Main.html#8719a8ac37ff6bb66048ca8967dbd782">quit()</a> has been called for the innermost main loop. </dd></dl>
</div>
</div><p>
<a class="anchor" name="681a82f7118d71188e64ba9379bb33e7"></a><!-- doxytag: member="Gtk::Main::iteration_impl" ref="681a82f7118d71188e64ba9379bb33e7" args="(bool blocking)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual bool Gtk::Main::iteration_impl </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>blocking</em> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="78f66b89dbe811cdce075a8b00c8987a"></a><!-- doxytag: member="Gtk::Main::level" ref="78f66b89dbe811cdce075a8b00c8987a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static guint Gtk::Main::level </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="ad90e366d331016ce5ff68023f214d8b"></a><!-- doxytag: member="Gtk::Main::level_impl" ref="ad90e366d331016ce5ff68023f214d8b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual guint Gtk::Main::level_impl </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="7c3bb918c54342b71e9e56d999b4dd4e"></a><!-- doxytag: member="Gtk::Main::on_window_hide" ref="7c3bb918c54342b71e9e56d999b4dd4e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Main::on_window_hide </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="8719a8ac37ff6bb66048ca8967dbd782"></a><!-- doxytag: member="Gtk::Main::quit" ref="8719a8ac37ff6bb66048ca8967dbd782" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gtk::Main::quit </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Makes the innermost invocation of the main loop return when it regains control.
<p>
</div>
</div><p>
<a class="anchor" name="785e09dce370a1c5260885ced9efb4a6"></a><!-- doxytag: member="Gtk::Main::quit_impl" ref="785e09dce370a1c5260885ced9efb4a6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Main::quit_impl </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="aa2e4e282834cbe2d789fe34c447a0dd"></a><!-- doxytag: member="Gtk::Main::run" ref="aa2e4e282834cbe2d789fe34c447a0dd" args="(Window &window)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gtk::Main::run </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGtk_1_1Window.html">Window</a>& </td>
<td class="paramname"> <em>window</em> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns from the main loop when the window is closed.
<p>
When using this override, you should not use <a class="el" href="classGtk_1_1Main.html#8719a8ac37ff6bb66048ca8967dbd782">Gtk::Main::quit()</a> to close the application, but just call hide() on your <a class="el" href="classGtk_1_1Window.html">Window</a> class.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>window</em> </td><td>The window to show. This method will return when the window is hidden. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="6a8904c35952006d13cb07c1d0c16c10"></a><!-- doxytag: member="Gtk::Main::run" ref="6a8904c35952006d13cb07c1d0c16c10" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void Gtk::Main::run </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Start the event loop.
<p>
This begins the event loop which handles events. No events propagate until this has been called. It may be called recursively to popup dialogs
</div>
</div><p>
<a class="anchor" name="2642c570bde971015f97b97cce743f80"></a><!-- doxytag: member="Gtk::Main::run_impl" ref="2642c570bde971015f97b97cce743f80" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Main::run_impl </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="b4c316c0789dfb4ab7926e062196c4e5"></a><!-- doxytag: member="Gtk::Main::signal_key_snooper" ref="b4c316c0789dfb4ab7926e062196c4e5" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static KeySnooperSig& Gtk::Main::signal_key_snooper </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
KeySnooper signal Allows you to channel keypresses to a signal handler without registering with the widget.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>KeySnooperSig A Signal to which you can connect a sigc::slot< int, Widget *, GdkEventKey * ></dd></dl>
It is the responsibility of the snooper to pass the keypress to the widget, however, care must be taken that the keypress is not passed twice.
</div>
</div><p>
<a class="anchor" name="c1b6ae5b79cb84158f3caf3e9382492d"></a><!-- doxytag: member="Gtk::Main::signal_quit" ref="c1b6ae5b79cb84158f3caf3e9382492d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static QuitSig& Gtk::Main::signal_quit </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Quit signal You can connect signal handlers to invoke actions when <a class="el" href="classGtk_1_1Main.html#8719a8ac37ff6bb66048ca8967dbd782">Gtk::Main::quit()</a> has been called.
<p>
Note that main loops can be nested by calling <a class="el" href="classGtk_1_1Main.html#6a8904c35952006d13cb07c1d0c16c10">Gtk::Main::run()</a> recursively, therefore receiving this signal doesn't necessarily mean the application is about to be terminated. If you want to receive a signal only when the last main loop quits, call connect() with <code>main_level = 1</code>. <div class="fragment"><pre class="fragment"> <span class="keywordtype">bool</span> thisclass::mymethod() { <span class="keywordflow">return</span> <span class="keyword">false</span>; }
<a class="code" href="classGtk_1_1Main.html#c1b6ae5b79cb84158f3caf3e9382492d">Gtk::Main::signal_quit</a>().connect(sigc::mem_fun(<span class="keyword">this</span>, &thisclass::mymethod));
</pre></div> <dl class="return" compact><dt><b>Returns:</b></dt><dd>bool - <code>false</code> means callback is removed, <code>true</code> means it'll be called again the next the main loop quits. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ec1562f7b2a23858472aa94d23b66173"></a><!-- doxytag: member="Gtk::Main::signal_run" ref="ec1562f7b2a23858472aa94d23b66173" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static RunSig& Gtk::Main::signal_run </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Run signal.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>void </dd></dl>
</div>
</div><p>
<hr><h2>Member Data Documentation</h2>
<a class="anchor" name="97582880bbb0ac12e957861a7ed165a3"></a><!-- doxytag: member="Gtk::Main::signal_key_snooper_" ref="97582880bbb0ac12e957861a7ed165a3" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KeySnooperSig <a class="el" href="classGtk_1_1Main.html#97582880bbb0ac12e957861a7ed165a3">Gtk::Main::signal_key_snooper_</a><code> [static, protected]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="ee8ba380608053d85a98847eaeb564da"></a><!-- doxytag: member="Gtk::Main::signal_quit_" ref="ee8ba380608053d85a98847eaeb564da" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QuitSig <a class="el" href="classGtk_1_1Main.html#ee8ba380608053d85a98847eaeb564da">Gtk::Main::signal_quit_</a><code> [static, protected]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="459e2ec96368ff1c28f351496c3200d6"></a><!-- doxytag: member="Gtk::Main::signal_run_" ref="459e2ec96368ff1c28f351496c3200d6" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RunSig <a class="el" href="classGtk_1_1Main.html#459e2ec96368ff1c28f351496c3200d6">Gtk::Main::signal_run_</a><code> [static, protected]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="main_8h.html">main.h</a></ul>
</div>
<!-- end main content -->
<hr><address><small>
Generated for gtkmm 2.4 by <a href="http://www.doxygen.org/index.html">
Doxygen</a> 1.5.1 © 1997-2001</small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
9411cff4bc6d4e61b29ae81cd24665af
>
files
>
482
