<html> <head><title>Gtk-- Reference: Gtk::Statusbar</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Statusbar</h1><p> <b> Text status indicator</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AHBox.html">Gtk::HBox</a> <br> Derived by: <i>none</i> <p> #include <gtk--/statusbar.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2800"><tt><font color=blue><b>Statusbar</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>guint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2803"><tt><font color=blue><b>get_context_id</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>context_description</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkStatusbar</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2795"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkStatusbar</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2796"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2797"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AStatusbar.html#2799">MsgList</a>&</tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2810"><tt><font color=blue><b>messages</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <a href="Gtk%3A%3AStatusbar.html#2799">MsgList</a>&</tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2811"><tt><font color=blue><b>messages</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AStatusbar.html#2806">iterator</a></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2807"><tt><font color=blue><b>messages_begin</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AStatusbar.html#2806">iterator</a></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2808"><tt><font color=blue><b>messages_end</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2805"><tt><font color=blue><b>pop</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>context_id</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>guint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2804"><tt><font color=blue><b>push</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>context_id</font></tt>, <tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>text</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2809"><tt><font color=blue><b>remove_message</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>context_id</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>message_id</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2802"><tt><font color=blue><b>text_popped</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>*)</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2801"><tt><font color=blue><b>text_pushed</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>*)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2798"><tt><font color=blue><b>~Statusbar</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>protected function member index:</h3></td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2813"><tt><font color=blue><b>text_popped_impl</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>p0</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>* <tt><font color=blue>p1</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AStatusbar.html#2812"><tt><font color=blue><b>text_pushed_impl</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>p0</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>* <tt><font color=blue>p1</font></tt>)</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> This widget is used to display status information. Messages are pushed and poped onto a message stack. When text is pushed it replaces the old contents. The old text is restored when popped. <P> It derives from Gtk_HBox so that additional information can be added easily. <P> The message list can be accessed through the messages() list.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="2803"><font size=+1><b>Gtk::Statusbar::get_context_id</b></font></a> - Returns a new context identifier, given a description of the actual context.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>guint</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2803"><tt><font color=blue><b>get_context_id</b></font></tt></a><tt>(<tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>context_description</font></tt>) <tt>const</tt></tt>;<br><blockquote> <tt><font color=blue>context_description</font></tt>: Textual description of what context the new message is being used in. <P> <tt><font color=blue>Returns</font></tt>: An integer id.</blockquote> <br><br> <a name="2795"><font size=+1><b>Gtk::Statusbar::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkStatusbar</font></tt>*</tt> <a href="Gtk%3A%3AStatusbar.html#2795"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="2797"><font size=+1><b>Gtk::Statusbar::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2797"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="2805"><font size=+1><b>Gtk::Statusbar::pop</b></font></a> - Removes the message at the top of a GtkStatusBar's stack.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2805"><tt><font color=blue><b>pop</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>context_id</font></tt>)</tt>;<br><blockquote> <tt><font color=blue>context_id</font></tt>: A context identifier.</blockquote> <br><br> <a name="2804"><font size=+1><b>Gtk::Statusbar::push</b></font></a> - Pushes a new message onto a statusbar's stack.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>guint</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2804"><tt><font color=blue><b>push</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>context_id</font></tt>, <tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>text</font></tt>)</tt>;<br><blockquote> <tt><font color=blue>context_id</font></tt>: The message's context id, as returned by <a href="Gtk%3A%3AStatusbar.html#2803"><tt><font color=blue><b>get_context_id</b></font></tt></a>. <P> <tt><font color=blue>text</font></tt>: The message to add to the statusbar. <P> <tt><font color=blue>Returns</font></tt>: The message's new message id for use with <tt><font color=blue><b></b></font></tt>.</blockquote> <br><br> <a name="2809"><font size=+1><b>Gtk::Statusbar::remove_message</b></font></a> - Forces the removal of a message from a statusbar's stack. The exact context_id and message_id must be specified.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2809"><tt><font color=blue><b>remove_message</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>context_id</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>message_id</font></tt>)</tt>;<br><blockquote> <tt><font color=blue>context_id</font></tt>: A context identifier. <P> <tt><font color=blue>message_id</font></tt>: A message identifier, as returned by <a href="Gtk%3A%3AStatusbar.html#2804"><tt><font color=blue><b>push</b></font></tt></a>.</blockquote> <br><br> <a name="2802"><font size=+1><b>Gtk::Statusbar::text_popped</b></font></a> - Is emitted whenever a new message is popped off a statusbar's stack.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2802"><tt><font color=blue><b>text_popped</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>*)</tt>;<br><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2813"><tt><font color=blue><b>text_popped_impl</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>p0</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>* <tt><font color=blue>p1</font></tt>)</tt>;<br><br> <a name="2801"><font size=+1><b>Gtk::Statusbar::text_pushed</b></font></a> - Is emitted whenever a new message gets pushed onto a statusbar's stack.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2801"><tt><font color=blue><b>text_pushed</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>*)</tt>;<br><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AStatusbar.html#2812"><tt><font color=blue><b>text_pushed_impl</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>p0</font></tt>, <tt>const</tt> <tt><font color=purple>gchar</font></tt>* <tt><font color=blue>p1</font></tt>)</tt>;<br><br> <hr noshade> </html>