<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
>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
425
