<HTML
><HEAD
><TITLE
>GnomeIconList</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><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="GnomeIconTextItem"
HREF="gnomeicontextitem.html"><LINK
REL="NEXT"
TITLE="GnomeIconSelection"
HREF="gnomeiconselection.html"></HEAD
><BODY
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="gnomeicontextitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; 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="gnomeiconselection.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEICONLIST"
>GnomeIconList</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN18473"
></A
><H2
>Name</H2
>GnomeIconList&nbsp;--&nbsp;A list of icons with captions, with optional caption editing.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18476"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeiconlist.html#GNOMEICONLIST-STRUCT"
>GnomeIconList</A
>;
#define     <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-IS-EDITABLE"
>GNOME_ICON_LIST_IS_EDITABLE</A
>
#define     <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-STATIC-TEXT"
>GNOME_ICON_LIST_STATIC_TEXT</A
>
enum        <A
HREF="gnomeiconlist.html#GNOMEICONLISTMODE"
>GnomeIconListMode</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-NEW"
>gnome_icon_list_new</A
>             (<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> icon_width,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *adj,
                                             int flags);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-NEW-FLAGS"
>gnome_icon_list_new_flags</A
>       (<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> icon_width,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *adj,
                                             int flags);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-CONSTRUCT"
>gnome_icon_list_construct</A
>       (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> icon_width,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *adj,
                                             int flags);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-HADJUSTMENT"
>gnome_icon_list_set_hadjustment</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *hadj);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-VADJUSTMENT"
>gnome_icon_list_set_vadjustment</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *vadj);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-FREEZE"
>gnome_icon_list_freeze</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-THAW"
>gnome_icon_list_thaw</A
>            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-INSERT"
>gnome_icon_list_insert</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             const char *icon_filename,
                                             const char *text);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-INSERT-IMLIB"
>gnome_icon_list_insert_imlib</A
>    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *im,
                                             const char *text);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-APPEND"
>gnome_icon_list_append</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *icon_filename,
                                             const char *text);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-APPEND-IMLIB"
>gnome_icon_list_append_imlib</A
>    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *im,
                                             char *text);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-CLEAR"
>gnome_icon_list_clear</A
>           (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-REMOVE"
>gnome_icon_list_remove</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-SELECTION-MODE"
>gnome_icon_list_set_selection_mode</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GTKSELECTIONMODE"
>GtkSelectionMode</GTKDOCLINK
> mode);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SELECT-ICON"
>gnome_icon_list_select_icon</A
>     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int idx);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-UNSELECT-ICON"
>gnome_icon_list_unselect_icon</A
>   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-UNSELECT-ALL"
>gnome_icon_list_unselect_all</A
>    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GDKEVENT"
>GdkEvent</GTKDOCLINK
> *event,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> keep);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-WIDTH"
>gnome_icon_list_set_icon_width</A
>  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int w);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ROW-SPACING"
>gnome_icon_list_set_row_spacing</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-COL-SPACING"
>gnome_icon_list_set_col_spacing</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-TEXT-SPACING"
>gnome_icon_list_set_text_spacing</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-BORDER"
>gnome_icon_list_set_icon_border</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-SEPARATORS"
>gnome_icon_list_set_separators</A
>  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *sep);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-DATA"
>gnome_icon_list_set_icon_data</A
>   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-DATA-FULL"
>gnome_icon_list_set_icon_data_full</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> destroy);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-FIND-ICON-FROM-DATA"
>gnome_icon_list_find_icon_from_data</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
>    <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-GET-ICON-DATA"
>gnome_icon_list_get_icon_data</A
>   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-MOVETO"
>gnome_icon_list_moveto</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> yalign);
<GTKDOCLINK
HREF="GTKVISIBILITY"
>GtkVisibility</GTKDOCLINK
> <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-ICON-IS-VISIBLE"
>gnome_icon_list_icon_is_visible</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-GET-ICON-AT"
>gnome_icon_list_get_icon_at</A
>     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int x,
                                             int y);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-GET-ITEMS-PER-LINE"
>gnome_icon_list_get_items_per_line</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18565"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>
         +----<GTKDOCLINK
HREF="GTKCONTAINER"
>GtkContainer</GTKDOCLINK
>
               +----<GTKDOCLINK
HREF="GTKLAYOUT"
>GtkLayout</GTKDOCLINK
>
                     +----<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
>
                           +----GnomeIconList</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18573"
></A
><H2
>Description</H2
><P
>    The GNOME icon list widget can hold a number of icons with
    captions.  The icons on the list can be selected (various
    selection methods are supported).  The programmer can enable
    caption-editing for the icons.  This parameters is configured when
    you create the icon list widget.
  </P
><P
>    You can control the type of selection mode you desire by using the
    <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-SELECTION-MODE"
>gnome_icon_list_set_selection_mode</A
>() function.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18578"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18580"
></A
><H3
><A
NAME="GNOMEICONLIST-STRUCT"
></A
>struct GnomeIconList</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeIconList;</PRE
></TD
></TR
></TABLE
><P
>    All fields in the <SPAN
CLASS="STRUCTNAME"
>GnomeIconList</SPAN
> structure
    are private, except for the <TT
CLASS="STRUCTFIELD"
><I
>selection</I
></TT
>
    field which you must query to get information about which icons
    are currently selected in the icon list.
  </P
><P
>    The <TT
CLASS="STRUCTFIELD"
><I
>selection</I
></TT
> field of the
    <SPAN
CLASS="STRUCTNAME"
>GnomeIconList</SPAN
> structure is a linked list
    that holds the indices of the icons that are selected at any one
    time.  The <TT
CLASS="STRUCTFIELD"
><I
>data</I
></TT
> pointer in each link of
    the list can be casted to an integer, preferably using the
    <TT
CLASS="FUNCTION"
><GTKDOCLINK
HREF="GPOINTER-TO-INT"
>GPOINTER_TO_INT</GTKDOCLINK
>()</TT
> macro, to get the index of
    the icon represented by that link:

    <TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static void
print_selected_icons (GnomeIconList *gil)
{
	GList *l;
	int i;

	for (l = gil-&gt;selection; l; l = l-&gt;next) {
		i = GPOINTER_TO_INT (l-&#62;data)
		printf ("Icon number &percnt;d is selected\n", i);
	}
}
    </PRE
></TD
></TR
></TABLE
>
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18594"
></A
><H3
><A
NAME="GNOME-ICON-LIST-IS-EDITABLE"
></A
>GNOME_ICON_LIST_IS_EDITABLE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_ICON_LIST_IS_EDITABLE 1</PRE
></TD
></TR
></TABLE
><P
>    This macro is a flag passed to the constructor functions.  It is
    used to specify that the icon list should have editable text
    captions.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18599"
></A
><H3
><A
NAME="GNOME-ICON-LIST-STATIC-TEXT"
></A
>GNOME_ICON_LIST_STATIC_TEXT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_ICON_LIST_STATIC_TEXT 2</PRE
></TD
></TR
></TABLE
><P
>    This macro is a flag passed to the constructor functions.  It is
    used to specify whether an icon list makes copies of the text in
    the icon captions or whether it just keeps pointers to the text
    strings supplied by the application.  If this flag is specified,
    then the icon list will just store pointers to the original text
    strings specified by the application, which must then guarantee
    that they will not be freed or changed until the icon list no
    longer needs them.  If it is not specified, then the icon list
    will make copies of the text strings specified by the application.
  </P
><P
>    Applications with very big icon lists can save memory by
    specifying this flag and being careful about when to free the text
    strings that are used for the icon captions.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18605"
></A
><H3
><A
NAME="GNOMEICONLISTMODE"
></A
>enum GnomeIconListMode</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_ICON_LIST_ICONS,
	GNOME_ICON_LIST_TEXT_BELOW,
	GNOME_ICON_LIST_TEXT_RIGHT
} GnomeIconListMode;</PRE
></TD
></TR
></TABLE
><P
>    The use of this enumeration is currently not implemented.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18610"
></A
><H3
><A
NAME="GNOME-ICON-LIST-NEW"
></A
>gnome_icon_list_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_icon_list_new             (<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> icon_width,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *adj,
                                             int flags);</PRE
></TD
></TR
></TABLE
><P
>This function is kept for binary compatibility with old applications.  It is
similar in purpose to <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-NEW-FLAGS"
>gnome_icon_list_new_flags</A
>(), but it will always turn on
the <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> flag.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width for the icon columns.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Adjustment to be used for vertical scrolling.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A combination of <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> and <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly-created icon list widget</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18644"
></A
><H3
><A
NAME="GNOME-ICON-LIST-NEW-FLAGS"
></A
>gnome_icon_list_new_flags ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_icon_list_new_flags       (<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> icon_width,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *adj,
                                             int flags);</PRE
></TD
></TR
></TABLE
><P
>Creates a new icon list widget.  The icon columns are allocated a width of
<TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
> pixels.  Icon captions will be word-wrapped to this width as
well.</P
><P
>The adjustment is used to pass an existing adjustment to be used to control
the icon list's vertical scrolling.  Normally NULL can be passed here; if the
icon list is inserted into a &amp;GtkScrolledWindow, it will handle scrolling
automatically.</P
><P
>If <TT
CLASS="PARAMETER"
><I
>flags</I
></TT
> has the <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> flag set, then the user will be
able to edit the text in the icon captions, and the "text_changed" signal
will be emitted when an icon's text is changed.</P
><P
>If <TT
CLASS="PARAMETER"
><I
>flags</I
></TT
> has the <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
> flags set, then the text
for the icon captions will not be copied inside the icon list; it will only
store the pointers to the original text strings specified by the application.
This is intended to save memory.  If this flag is not set, then the text
strings will be copied and managed internally.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width for the icon columns.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>        Adjustment to be used for vertical scrolling.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>      A combination of <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> and <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly-created icon list widget</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18684"
></A
><H3
><A
NAME="GNOME-ICON-LIST-CONSTRUCT"
></A
>gnome_icon_list_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_construct       (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> icon_width,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *adj,
                                             int flags);</PRE
></TD
></TR
></TABLE
><P
>Constructor for the icon list, to be used by derived classes.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width for the icon columns.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Adjustment to be used for vertical scrolling.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A combination of <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> and <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18716"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-HADJUSTMENT"
></A
>gnome_icon_list_set_hadjustment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_hadjustment (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *hadj);</PRE
></TD
></TR
></TABLE
><P
>Sets the adjustment to be used for horizontal scrolling.  This is normally
not required, as the icon list can be simply inserted in a &amp;GtkScrolledWindow
and scrolling will be handled automatically.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>hadj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Adjustment to be used for horizontal scrolling.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18737"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-VADJUSTMENT"
></A
>gnome_icon_list_set_vadjustment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_vadjustment (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GTKADJUSTMENT"
>GtkAdjustment</GTKDOCLINK
> *vadj);</PRE
></TD
></TR
></TABLE
><P
>Sets the adjustment to be used for vertical scrolling.  This is normally not
required, as the icon list can be simply inserted in a &amp;GtkScrolledWindow and
scrolling will be handled automatically.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>vadj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18758"
></A
><H3
><A
NAME="GNOME-ICON-LIST-FREEZE"
></A
>gnome_icon_list_freeze ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_freeze          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
>Freezes an icon list so that any changes made to it will not be
reflected on the screen until it is thawed with <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-THAW"
>gnome_icon_list_thaw</A
>().
It is recommended to freeze the icon list before inserting or deleting
many icons, for example, so that the layout process will only be executed
once, when the icon list is finally thawed.</P
><P
>You can call this function multiple times, but it must be balanced with the
same number of calls to <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-THAW"
>gnome_icon_list_thaw</A
>() before the changes will take
effect.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18777"
></A
><H3
><A
NAME="GNOME-ICON-LIST-THAW"
></A
>gnome_icon_list_thaw ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_thaw            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
>Thaws the icon list and performs any pending layout operations.  This
is to be used in conjunction with <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-FREEZE"
>gnome_icon_list_freeze</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18794"
></A
><H3
><A
NAME="GNOME-ICON-LIST-INSERT"
></A
>gnome_icon_list_insert ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_insert          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             const char *icon_filename,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Inserts an icon in the specified icon list.  The icon's image is loaded
from the specified file, and it is inserted at the <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> index.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>           An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>           Position at which the new icon should be inserted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the file that holds the icon's image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>          Text to be used for the icon's caption.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18823"
></A
><H3
><A
NAME="GNOME-ICON-LIST-INSERT-IMLIB"
></A
>gnome_icon_list_insert_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_insert_imlib    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *im,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Inserts an icon in the specified icon list.  The icon is created from the
specified Imlib image, and it is inserted at the <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> index.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Position at which the new icon should be inserted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Imlib image with the icon image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to be used for the icon's caption.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18853"
></A
><H3
><A
NAME="GNOME-ICON-LIST-APPEND"
></A
>gnome_icon_list_append ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_append          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *icon_filename,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Appends an icon to the specified icon list.  The icon's image is loaded from
the specified file, and it is inserted at the <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> index.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>           An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the file that holds the icon's image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>          Text to be used for the icon's caption.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18882"
></A
><H3
><A
NAME="GNOME-ICON-LIST-APPEND-IMLIB"
></A
>gnome_icon_list_append_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_append_imlib    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *im,
                                             char *text);</PRE
></TD
></TR
></TABLE
><P
>Appends an icon to the specified icon list.  The icon is created from
the specified Imlib image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Imlib image with the icon image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to be used for the icon's caption.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18911"
></A
><H3
><A
NAME="GNOME-ICON-LIST-CLEAR"
></A
>gnome_icon_list_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_clear           (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
>Clears the contents for the icon list by removing all the icons.  If destroy
handlers were specified for any of the icons, they will be called with the
appropriate data.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18927"
></A
><H3
><A
NAME="GNOME-ICON-LIST-REMOVE"
></A
>gnome_icon_list_remove ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_remove          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
>Removes the icon at index position <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.  If a destroy handler was specified
for that icon, it will be called with the appropriate data.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Index of the icon that should be removed.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18948"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-SELECTION-MODE"
></A
>gnome_icon_list_set_selection_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_selection_mode
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GTKSELECTIONMODE"
>GtkSelectionMode</GTKDOCLINK
> mode);</PRE
></TD
></TR
></TABLE
><P
>Sets the selection mode for an icon list.  The <TT
CLASS="LITERAL"
>GTK_SELECTION_MULTIPLE</TT
> and
<TT
CLASS="LITERAL"
>GTK_SELECTION_EXTENDED</TT
> modes are considered equivalent.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mode</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New selection mode.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18971"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SELECT-ICON"
></A
>gnome_icon_list_select_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_select_icon     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int idx);</PRE
></TD
></TR
></TABLE
><P
>Selects the icon at the index specified by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>idx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18992"
></A
><H3
><A
NAME="GNOME-ICON-LIST-UNSELECT-ICON"
></A
>gnome_icon_list_unselect_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_unselect_icon   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
>Unselects the icon at the index specified by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Index of the icon to be unselected.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19013"
></A
><H3
><A
NAME="GNOME-ICON-LIST-UNSELECT-ALL"
></A
>gnome_icon_list_unselect_all ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_unselect_all    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GDKEVENT"
>GdkEvent</GTKDOCLINK
> *event,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> keep);</PRE
></TD
></TR
></TABLE
><P
>Unselects all the icons in the icon list.  The <TT
CLASS="PARAMETER"
><I
>event</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>keep</I
></TT
> parameters
must be NULL, since they are used only internally.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Unused, must be NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>keep</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  For internal use only; must be NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the number of icons in the icon list</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19045"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-WIDTH"
></A
>gnome_icon_list_set_icon_width ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_width  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int w);</PRE
></TD
></TR
></TABLE
><P
>Sets the amount of horizontal space allocated to the icons, i.e. the column
width of the icon list.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   New width for the icon columns.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19065"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ROW-SPACING"
></A
>gnome_icon_list_set_row_spacing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_row_spacing (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the spacing to be used between rows of icons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of pixels for inter-row spacing.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19085"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-COL-SPACING"
></A
>gnome_icon_list_set_col_spacing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_col_spacing (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the spacing to be used between columns of icons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of pixels for inter-column spacing.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19105"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-TEXT-SPACING"
></A
>gnome_icon_list_set_text_spacing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_text_spacing
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the spacing to be used between an icon's image and its text caption.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of pixels between an icon's image and its caption.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19125"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-BORDER"
></A
>gnome_icon_list_set_icon_border ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_border (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the width of the border to be displayed around an icon's image.  This is
currently not implemented.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of border pixels to be used around an icon's image.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19145"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-SEPARATORS"
></A
>gnome_icon_list_set_separators ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_separators  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *sep);</PRE
></TD
></TR
></TABLE
><P
>Sets the characters that can be used as word separators when doing
word-wrapping in the icon text captions.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>sep</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String with characters to be used as word separators.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19165"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-DATA"
></A
>gnome_icon_list_set_icon_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_data   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19189"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-DATA-FULL"
></A
>gnome_icon_list_set_icon_data_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_data_full
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> destroy);</PRE
></TD
></TR
></TABLE
><P
>Associates the <TT
CLASS="PARAMETER"
><I
>data</I
></TT
> pointer to the icon at the index specified by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.  The
<TT
CLASS="PARAMETER"
><I
>destroy</I
></TT
> argument points to a function that will be called when the icon is
destroyed, or NULL if no function is to be called when this happens.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>     An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>     Index of an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    User data to set on the icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>destroy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Destroy notification handler for the icon.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19222"
></A
><H3
><A
NAME="GNOME-ICON-LIST-FIND-ICON-FROM-DATA"
></A
>gnome_icon_list_find_icon_from_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_find_icon_from_data
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Data pointer associated to an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the index of the icon whose user data has been set to <TT
CLASS="PARAMETER"
><I
>data</I
></TT
>,
or -1 if no icon has this data associated to it.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19248"
></A
><H3
><A
NAME="GNOME-ICON-LIST-GET-ICON-DATA"
></A
>gnome_icon_list_get_icon_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
>    gnome_icon_list_get_icon_data   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Index of an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the user data pointer associated to the icon at the index specified
by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19274"
></A
><H3
><A
NAME="GNOME-ICON-LIST-MOVETO"
></A
>gnome_icon_list_moveto ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_moveto          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> yalign);</PRE
></TD
></TR
></TABLE
><P
>Makes the icon whose index is <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> be visible on the screen.  The icon list
gets scrolled so that the icon is visible.  An alignment of 0.0 represents
the top of the visible part of the icon list, and 1.0 represents the bottom.
An icon can be centered on the icon list.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    Index of an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>yalign</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertical alignment of the icon.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19300"
></A
><H3
><A
NAME="GNOME-ICON-LIST-ICON-IS-VISIBLE"
></A
>gnome_icon_list_icon_is_visible ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKVISIBILITY"
>GtkVisibility</GTKDOCLINK
> gnome_icon_list_icon_is_visible
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19324"
></A
><H3
><A
NAME="GNOME-ICON-LIST-GET-ICON-AT"
></A
>gnome_icon_list_get_icon_at ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_get_icon_at     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int x,
                                             int y);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   X position in the icon list window.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Y position in the icon list window.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the index of the icon that is under the specified coordinates, which
are relative to the icon list's window.  If there is no icon in that
position, -1 is returned.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19352"
></A
><H3
><A
NAME="GNOME-ICON-LIST-GET-ITEMS-PER-LINE"
></A
>gnome_icon_list_get_items_per_line ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_get_items_per_line
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of icons that fit in a line or row.</TD
></TR
></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="gnomeicontextitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; 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="gnomeiconselection.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconTextItem</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconSelection</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>