<HTML ><HEAD ><TITLE >GnomeAbout</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="GNOME Widgets and Objects" HREF="gnome-objects.html"><LINK REL="NEXT" TITLE="GnomeAnimator" HREF="gnomeanimator.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="gnome-objects.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" ><A HREF="gnomeanimator.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOMEABOUT" >GnomeAbout</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN7838" ></A ><H2 >Name</H2 >GnomeAbout -- Simple way to provide an About box for your application.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN7841" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> struct <A HREF="gnomeabout.html#GNOMEABOUT-STRUCT" >GnomeAbout</A >; <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomeabout.html#GNOME-ABOUT-NEW" >gnome_about_new</A > (const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *title, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *version, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *copyright, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > **authors, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *comments, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *logo); void <A HREF="gnomeabout.html#GNOME-ABOUT-CONSTRUCT" >gnome_about_construct</A > (<A HREF="gnomeabout.html" >GnomeAbout</A > *about, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *title, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *version, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *copyright, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > **authors, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *comments, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *logo); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN7861" ></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="GTKBIN" >GtkBin</GTKDOCLINK > +----<GTKDOCLINK HREF="GTKWINDOW" >GtkWindow</GTKDOCLINK > +----<A HREF="gnomedialog.html" >GnomeDialog</A > +----GnomeAbout</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN7870" ></A ><H2 >Description</H2 ><P >A standard way of providing a small about box for your application. You provide the name of your application, version, copyright, a list of authors and some comments about your application. It also allows the programmer to provide a logo to be displayed.</P ><P >The following is a simple example of its use, note that the descriptive text is surrounded by the <GTKDOCLINK HREF="GETTEXT-MACRO" >_</GTKDOCLINK >(). This will have the text translated to the the user's language at runtime.</P ><DIV CLASS="INFORMALEXAMPLE" ><A NAME="AEN7875" ></A ><P ></P ><TABLE BORDER="0" BGCOLOR="#D8F8D8" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const gchar *authors[] = { "Wanda the sexy fish", NULL }; gtk_widget_show (gnome_about_new ("Gnome Wizit", VERSION, "Copyright 1999 Gnome Programming Inc.", (const gchar **) authors, _("The gnome wizit is the most fabulous thing ever " "written for the GNOME desktop environment. You must " "use this everyday."), NULL)); </PRE ></TD ></TR ></TABLE ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN7877" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN7879" ></A ><H3 ><A NAME="GNOMEABOUT-STRUCT" ></A >struct GnomeAbout</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >struct GnomeAbout;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN7884" ></A ><H3 ><A NAME="GNOME-ABOUT-NEW" ></A >gnome_about_new ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_about_new (const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *title, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *version, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *copyright, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > **authors, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *comments, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *logo);</PRE ></TD ></TR ></TABLE ><P >Creates a new GNOME About dialog. <TT CLASS="PARAMETER" ><I >title</I ></TT >, <TT CLASS="PARAMETER" ><I >version</I ></TT >, <TT CLASS="PARAMETER" ><I >copyright</I ></TT >, and <TT CLASS="PARAMETER" ><I >authors</I ></TT > are displayed first, in that order. <TT CLASS="PARAMETER" ><I >comments</I ></TT > is typically the location for multiple lines of text, if necessary. (Separate with "\n".) <TT CLASS="PARAMETER" ><I >logo</I ></TT > is the filename of a optional pixmap to be displayed in the dialog, typically a product or company logo of some sort; set to <TT CLASS="LITERAL" >NULL</TT > if no logo file is available.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN7904" ></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 >title</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Name of app.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >version</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > version number</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >copyright</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > copyright string</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >authors</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > <TT CLASS="LITERAL" >NULL</TT > terminated list of authors</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >comments</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Other comments</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >logo</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > a logo pixmap file.</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" >&GtkWidget pointer to new dialog</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN7938" ></A ><H3 ><A NAME="GNOME-ABOUT-CONSTRUCT" ></A >gnome_about_construct ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_about_construct (<A HREF="gnomeabout.html" >GnomeAbout</A > *about, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *title, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *version, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *copyright, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > **authors, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *comments, const <GTKDOCLINK HREF="GCHAR" >gchar</GTKDOCLINK > *logo);</PRE ></TD ></TR ></TABLE ><P >Constructs a new GNOME About dialog, given an object <TT CLASS="PARAMETER" ><I >about</I ></TT > newly created via the Gtk type system. <TT CLASS="PARAMETER" ><I >title</I ></TT >, <TT CLASS="PARAMETER" ><I >version</I ></TT >, <TT CLASS="PARAMETER" ><I >copyright</I ></TT >, and <TT CLASS="PARAMETER" ><I >authors</I ></TT > are displayed first, in that order. <TT CLASS="PARAMETER" ><I >comments</I ></TT > is typically the location for multiple lines of text, if necessary. (Separate with "\n".) <TT CLASS="PARAMETER" ><I >logo</I ></TT > is the filename of a optional pixmap to be displayed in the dialog, typically a product or company logo of some sort; set to <TT CLASS="LITERAL" >NULL</TT > if no logo file is available.</P ><P >Note: Only for use by bindings to languages other than C; don't use in applications.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN7960" ></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 >about</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to new GNOME about object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >title</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Name of app.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >version</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > version number</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >copyright</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > copyright string</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >authors</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > <TT CLASS="LITERAL" >NULL</TT > terminated list of authors</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >comments</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Other comments</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >logo</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > a logo pixmap file.</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="gnome-objects.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" ><A HREF="gnomeanimator.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GNOME Widgets and Objects</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GnomeAnimator</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >