<HTML ><HEAD ><TITLE >GnomeProcBar</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK REL="HOME" TITLE="Gnome User Interface Library Reference Manual" HREF="book1.html"><LINK REL="UP" TITLE="GNOME Widgets and Objects" HREF="gnome-objects.html"><LINK REL="PREVIOUS" TITLE="GnomeDockLayout" HREF="gnomedocklayout.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TH COLSPAN="4" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="5" >Gnome User Interface Library Reference Manual</FONT ></TH ></TR ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnomedocklayout.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="gnome-objects.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" > </TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOMEPROCBAR" >GnomeProcBar</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN26423" ></A ><H2 >Name</H2 >GnomeProcBar -- Gnome Process Bar</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN26426" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> struct <A HREF="gnomeprocbar.html#GNOMEPROCBAR-STRUCT" >GnomeProcBar</A >; #define <A HREF="gnomeprocbar.html#GNOME-PROC-BAR--CLASS-CAPS" >GNOME_PROC_BAR__CLASS</A > (klass) <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-NEW" >gnome_proc_bar_new</A > (<GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *label, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > n, <GTKDOCLINK HREF="GDKCOLOR" >GdkColor</GTKDOCLINK > *colors, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > (*cb) ()); void <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-SET-VALUES" >gnome_proc_bar_set_values</A > (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, unsigned <GTKDOCLINK HREF="VAL" >val</GTKDOCLINK >[]); void <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-SET-ORIENT" >gnome_proc_bar_set_orient</A > (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > vertical); void <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-START" >gnome_proc_bar_start</A > (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > gtime, <GTKDOCLINK HREF="GPOINTER" >gpointer</GTKDOCLINK > data); void <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-STOP" >gnome_proc_bar_stop</A > (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb); void <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-UPDATE" >gnome_proc_bar_update</A > (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, <GTKDOCLINK HREF="GDKCOLOR" >GdkColor</GTKDOCLINK > *colors); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN26452" ></A ><H2 >Object Hierarchy</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > <GTKDOCLINK HREF="GTKOBJECT" >GtkObject</GTKDOCLINK > +----<GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > +----<GTKDOCLINK HREF="GTKCONTAINER" >GtkContainer</GTKDOCLINK > +----<GTKDOCLINK HREF="GTKBOX" >GtkBox</GTKDOCLINK > +----<GTKDOCLINK HREF="GTKHBOX" >GtkHBox</GTKDOCLINK > +----GnomeProcBar</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN26460" ></A ><H2 >Description</H2 ><P >The GnomeProcBar widget is used to display load graphs like cpu usage, memory and swap load. It is for instance used in the cpumemusage applet and in GTop. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN26463" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN26465" ></A ><H3 ><A NAME="GNOMEPROCBAR-STRUCT" ></A >struct GnomeProcBar</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >struct GnomeProcBar;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26470" ></A ><H3 ><A NAME="GNOME-PROC-BAR--CLASS-CAPS" ></A >GNOME_PROC_BAR__CLASS()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define GNOME_PROC_BAR__CLASS(klass) GTK_CHECK_CLASS_CAST (klass, gnome_proc_bar_get_type (), GnomeProcBarClass)</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26475" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >klass</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26484" ></A ><H3 ><A NAME="GNOME-PROC-BAR-NEW" ></A >gnome_proc_bar_new ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_proc_bar_new (<GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > *label, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > n, <GTKDOCLINK HREF="GDKCOLOR" >GdkColor</GTKDOCLINK > *colors, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > (*cb) ());</PRE ></TD ></TR ></TABLE ><P >Creates a new Gnome Process Bar with <TT CLASS="PARAMETER" ><I >n</I ></TT > items with the colors of <TT CLASS="PARAMETER" ><I >colors</I ></TT >. To do automatic updating, you set the <TT CLASS="PARAMETER" ><I >cb</I ></TT > to a function which takes a single void pointer as an argument and returns <TT CLASS="LITERAL" >TRUE</TT > or <TT CLASS="LITERAL" >FALSE</TT >. When it returns <TT CLASS="LITERAL" >FALSE</TT > the timer stops running and the function stops getting called. You need to call <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-START" >gnome_proc_bar_start</A > with the time interval and the data argument that will be passed to the callback to actually start executing the timer.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26502" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >label</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Either <TT CLASS="LITERAL" >NULL</TT > or a <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK > that will be shown at the left side of the process bar.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >n</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Number of items.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >colors</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to an array of <TT CLASS="PARAMETER" ><I >n</I ></TT > <GTKDOCLINK HREF="GDKCOLOR" >GdkColor</GTKDOCLINK > elements.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >cb</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Callback function to update the process bar.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > The newly created <A HREF="gnomeprocbar.html" >GnomeProcBar</A > widget.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26532" ></A ><H3 ><A NAME="GNOME-PROC-BAR-SET-VALUES" ></A >gnome_proc_bar_set_values ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_proc_bar_set_values (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, unsigned <GTKDOCLINK HREF="VAL" >val</GTKDOCLINK >[]);</PRE ></TD ></TR ></TABLE ><P >Set the values of <TT CLASS="PARAMETER" ><I >pb</I ></TT > to <TT CLASS="PARAMETER" ><I >val</I ></TT > and redraw it. You will probably call this function in the callback to update the values.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26542" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >pb</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a <A HREF="gnomeprocbar.html" >GnomeProcBar</A > object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >Param2</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26556" ></A ><H3 ><A NAME="GNOME-PROC-BAR-SET-ORIENT" ></A >gnome_proc_bar_set_orient ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_proc_bar_set_orient (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > vertical);</PRE ></TD ></TR ></TABLE ><P >Sets the orientation of <TT CLASS="PARAMETER" ><I >pb</I ></TT > to vertical if <TT CLASS="PARAMETER" ><I >vertical</I ></TT > is <TT CLASS="LITERAL" >TRUE</TT > or to horizontal if <TT CLASS="PARAMETER" ><I >vertical</I ></TT > is <TT CLASS="LITERAL" >FALSE</TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26569" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >pb</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a <A HREF="gnomeprocbar.html" >GnomeProcBar</A > object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >vertical</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > <TT CLASS="LITERAL" >TRUE</TT > if vertical <TT CLASS="LITERAL" >FALSE</TT > if horizontal</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26585" ></A ><H3 ><A NAME="GNOME-PROC-BAR-START" ></A >gnome_proc_bar_start ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_proc_bar_start (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, <GTKDOCLINK HREF="GINT" >gint</GTKDOCLINK > gtime, <GTKDOCLINK HREF="GPOINTER" >gpointer</GTKDOCLINK > data);</PRE ></TD ></TR ></TABLE ><P >Start a timer, and call the callback that was set on <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-NEW" >gnome_proc_bar_new</A > with the <TT CLASS="PARAMETER" ><I >data</I ></TT >.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26596" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >pb</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a <A HREF="gnomeprocbar.html" >GnomeProcBar</A > object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >gtime</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > time interval in ms</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >data</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > data to the callback</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26614" ></A ><H3 ><A NAME="GNOME-PROC-BAR-STOP" ></A >gnome_proc_bar_stop ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_proc_bar_stop (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb);</PRE ></TD ></TR ></TABLE ><P >Stop running the callback in the timer.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26621" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >pb</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a <A HREF="gnomeprocbar.html" >GnomeProcBar</A > object</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN26631" ></A ><H3 ><A NAME="GNOME-PROC-BAR-UPDATE" ></A >gnome_proc_bar_update ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_proc_bar_update (<A HREF="gnomeprocbar.html" >GnomeProcBar</A > *pb, <GTKDOCLINK HREF="GDKCOLOR" >GdkColor</GTKDOCLINK > *colors);</PRE ></TD ></TR ></TABLE ><P >Update <TT CLASS="PARAMETER" ><I >pb</I ></TT > with <TT CLASS="PARAMETER" ><I >colors</I ></TT >. <TT CLASS="PARAMETER" ><I >pb</I ></TT > is not redrawn, it is only redrawn when you call <A HREF="gnomeprocbar.html#GNOME-PROC-BAR-SET-VALUES" >gnome_proc_bar_set_values</A ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN26643" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >pb</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to a <A HREF="gnomeprocbar.html" >GnomeProcBar</A > object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >colors</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to an array of <TT CLASS="PARAMETER" ><I >pb</I ></TT >->n <GTKDOCLINK HREF="GDKCOLOR" >GdkColor</GTKDOCLINK > elements</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><BR CLEAR="all"><BR><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnomedocklayout.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="gnome-objects.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" > </TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GnomeDockLayout</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" > </TD ></TR ></TABLE ></DIV ></BODY ></HTML >