📄 sec-statusbars.html

📁 gtk 开发手册和参考文档。包括gtk glib gdk等
💻 HTML
字号:
<HTML><HEAD><TITLE>Statusbars</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.49"><LINKREL="HOME"TITLE="GTK+ 1.2 Tutorial"HREF="gtk-tut.html"><LINKREL="UP"TITLE="Miscellaneous Widgets"HREF="ch-miscwidgets.html"><LINKREL="PREVIOUS"TITLE="Rulers"HREF="sec-rulers.html"><LINKREL="NEXT"TITLE="Text Entries"HREF="sec-textentries.html"></HEAD></head><body bgcolor="#FFFFFF" marginheight=0 marginwidth=0 width="100%"><table cellspacing=6 border=0 cellpadding=0 width="100%">  <tr>    <td bgcolor="#FFFFFF" valign=top nowrap>    <centeR><A HREF="/"><img src="/images/gtk-logo-rgb.gif" width=107 height=140 border=0></A>      <font face="helvetica,lucidia" color="#000000"><BR><BR><b>GTK+<BR>The GIMP Toolkit</b></center><BR><table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B>General</B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="/">Introduction</A><BR><A HREF="/screenshots/">Screenshots</A><br><A HREF="/download/">Download</A><br><A HREF="/mailinglists.html">Mailing Lists</A><BR><A HREF="/bindings.html">Language Bindings</A><BR><A HREF="http://gtk.themes.org/">Themes</A><BR><A HREF="/bugs.html">Bug Tracker</A><BR></td></tr></table></td></tr></table><BR>  <table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B>Documentation</B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="/faq/">FAQ</A><br><A HREF="/tutorial/">Tutorial</A><BR><A HREF="/api/">API Reference</A><br><A HREF="/books.html">Published Books</A><BR></td></tr></table></td></tr></table><BR>  <table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B>Projects</B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="http://www.pango.org/">Pango</A><BR><A HREF="http://sources.redhat.com/inti/">Inti</A><BR><A HREF="http://www.gnome.org/">GNOME</A><BR><A HREF="http://user.sgic.fi/~tml/gimp/win32/">GTK+ for Win32</A><br><A HREF="http://people.redhat.com/sopwith/gtkfb/">GtkFB (Framebuffer)</A><br><A HREF="http://www.directfb.org/gtk.xml">GTK+ on DirectFB</A><BR><A HREF="/beos/">GTK+ for BeOS</A></td></tr></table></td></tr></table><BR>  <table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B><B>Applications</B></B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="http://www.gimp.org/">GIMP</A><BR><A HREF="http://www.abiword.org/">Abiword</A><BR><A HREF="http://www.lysator.liu.se/~alla/dia/dia.html">Dia</A><BR><A HREF="http://glade.pn.org/">Glade</A><BR><A HREF="http://www.gnucash.org/">GnuCash</A><BR><A HREF="http://www.gnome.org/projects/gnumeric/">Gnumeric</A><BR><BR><A HREF="http://www.gnome.org/applist/">GNOME Software Map</A><br></td></tr></table></td></tr></table><BR>      </td>  <td bgcolor="#ffffff" valign=top width="99%"><font face="lucida,helvetica"><BODYCLASS="SECT1"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">GTK+ 1.2 Tutorial</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="sec-rulers.html">&#60;&#60;&#60; Previous</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom">Chapter 9. Miscellaneous Widgets</TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="sec-textentries.html">Next &#62;&#62;&#62;</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="SECT1"><H1CLASS="SECT1"><ANAME="SEC-STATUSBARS">9.8. Statusbars</A></H1><P>Statusbars are simple widgets used to display a text message. Theykeep a stack of the messages pushed onto them, so that popping thecurrent message will re-display the previous text message.</P><P>In order to allow different parts of an application to use the samestatusbar to display messages, the statusbar widget issues ContextIdentifiers which are used to identify different "users". The messageon top of the stack is the one displayed, no matter what context it isin. Messages are stacked in last-in-first-out order, not contextidentifier order.</P><P>A statusbar is created with a call to:</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">GtkWidget *gtk_statusbar_new( void );</PRE></TD></TR></TABLE><P>A new Context Identifier is requested using a call to the following function with a short textual description of the context:</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">guint gtk_statusbar_get_context_id( GtkStatusbar *statusbar,                                    const gchar  *context_description );</PRE></TD></TR></TABLE><P>There are three functions that can operate on statusbars:</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">guint gtk_statusbar_push( GtkStatusbar *statusbar,                          guint         context_id,                          gchar        *text );void gtk_statusbar_pop( GtkStatusbar *statusbar)                        guint         context_id );void gtk_statusbar_remove( GtkStatusbar *statusbar,                           guint         context_id,                           guint         message_id ); </PRE></TD></TR></TABLE><P>The first, gtk_statusbar_push, is used to add a new message to thestatusbar.  It returns a Message Identifier, which can be passed laterto the function gtk_statusbar_remove to remove the message with thegiven Message and Context Identifiers from the statusbar's stack.</P><P>The function gtk_statusbar_pop removes the message highest in thestack with the given Context Identifier.</P><P>The following example creates a statusbar and two buttons, one forpushing items onto the statusbar, and one for popping the last itemback off.</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">/* example-start statusbar statusbar.c */#include &#60;gtk/gtk.h&#62;#include &#60;glib.h&#62;GtkWidget *status_bar;void push_item( GtkWidget *widget,                gpointer   data ){  static int count = 1;  char buff[20];  g_snprintf(buff, 20, "Item %d", count++);  gtk_statusbar_push( GTK_STATUSBAR(status_bar), GPOINTER_TO_INT(data), buff);  return;}void pop_item( GtkWidget *widget,               gpointer   data ){  gtk_statusbar_pop( GTK_STATUSBAR(status_bar), GPOINTER_TO_INT(data) );  return;}int main( int   argc,          char *argv[] ){    GtkWidget *window;    GtkWidget *vbox;    GtkWidget *button;    gint context_id;    gtk_init (&#38;argc, &#38;argv);    /* create a new window */    window = gtk_window_new(GTK_WINDOW_TOPLEVEL);    gtk_widget_set_usize( GTK_WIDGET (window), 200, 100);    gtk_window_set_title(GTK_WINDOW (window), "GTK Statusbar Example");    gtk_signal_connect(GTK_OBJECT (window), "delete_event",                       (GtkSignalFunc) gtk_exit, NULL);     vbox = gtk_vbox_new(FALSE, 1);    gtk_container_add(GTK_CONTAINER(window), vbox);    gtk_widget_show(vbox);              status_bar = gtk_statusbar_new();          gtk_box_pack_start (GTK_BOX (vbox), status_bar, TRUE, TRUE, 0);    gtk_widget_show (status_bar);    context_id = gtk_statusbar_get_context_id(                          GTK_STATUSBAR(status_bar), "Statusbar example");    button = gtk_button_new_with_label("push item");    gtk_signal_connect(GTK_OBJECT(button), "clicked",        GTK_SIGNAL_FUNC (push_item), GINT_TO_POINTER(context_id) );    gtk_box_pack_start(GTK_BOX(vbox), button, TRUE, TRUE, 2);    gtk_widget_show(button);                  button = gtk_button_new_with_label("pop last item");    gtk_signal_connect(GTK_OBJECT(button), "clicked",        GTK_SIGNAL_FUNC (pop_item), GINT_TO_POINTER(context_id) );    gtk_box_pack_start(GTK_BOX(vbox), button, TRUE, TRUE, 2);    gtk_widget_show(button);    /* always display the window as the last step so it all splashes on     * the screen at once. */    gtk_widget_show(window);    gtk_main ();    return 0;}/* example-end */</PRE></TD></TR></TABLE></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLEWIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="sec-rulers.html">&#60;&#60;&#60; Previous</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="gtk-tut.html">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="sec-textentries.html">Next &#62;&#62;&#62;</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">Rulers</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="ch-miscwidgets.html">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">Text Entries</TD></TR></TABLE></DIV>        </td>    </tr></table>  </td>  </tr></table></body></BODY></HTML>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -