<HTML
><HEAD
><TITLE
>GnomeIconSelection</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="GnomeIconList"
HREF="gnomeiconlist.html"><LINK
REL="NEXT"
TITLE="GnomeLess"
HREF="gnomeless.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="gnomeiconlist.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="gnomeless.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEICONSELECTION"
>GnomeIconSelection</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN19437"
></A
><H2
>Name</H2
>GnomeIconSelection -- An icon listing/chooser display.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN19440"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> #include <gnome.h>
struct <A
HREF="gnomeiconselection.html#GNOMEICONSELECTION-STRUCT"
>GnomeIconSelection</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-NEW"
>gnome_icon_selection_new</A
> (void);
void <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DEFAULTS"
>gnome_icon_selection_add_defaults</A
>
(<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);
void <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DIRECTORY"
>gnome_icon_selection_add_directory</A
>
(<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *dir);
void <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SHOW-ICONS"
>gnome_icon_selection_show_icons</A
> (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);
void <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-CLEAR"
>gnome_icon_selection_clear</A
> (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> not_shown);
const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>* <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-GET-ICON"
>gnome_icon_selection_get_icon</A
> (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> full_path);
void <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SELECT-ICON"
>gnome_icon_selection_select_icon</A
>
(<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *filename); </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19463"
></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="GTKVBOX"
>GtkVBox</GTKDOCLINK
>
+----GnomeIconSelection</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19471"
></A
><H2
>Description</H2
><P
> This provides an icon chooser display. </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19474"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19476"
></A
><H3
><A
NAME="GNOMEICONSELECTION-STRUCT"
></A
>struct GnomeIconSelection</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeIconSelection;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19481"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-NEW"
></A
>gnome_icon_selection_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* gnome_icon_selection_new (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new icon selection widget, it uses GnomeIconList
for the listing of icons</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19488"
></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"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the new object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19497"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-ADD-DEFAULTS"
></A
>gnome_icon_selection_add_defaults ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_icon_selection_add_defaults
(<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);</PRE
></TD
></TR
></TABLE
><P
>Adds the default pixmap directory into the selection
widget. It doesn't show the icons in the selection until you
do <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SHOW-ICONS"
>gnome_icon_selection_show_icons</A
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19505"
></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
>gis</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19514"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-ADD-DIRECTORY"
></A
>gnome_icon_selection_add_directory ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_icon_selection_add_directory
(<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *dir);</PRE
></TD
></TR
></TABLE
><P
>Adds the icons from the directory <TT
CLASS="PARAMETER"
><I
>dir</I
></TT
> to the
selection widget. It doesn't show the icons in the selection
until you do <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SHOW-ICONS"
>gnome_icon_selection_show_icons</A
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19524"
></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
>gis</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dir</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> directory with pixmaps</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19537"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-SHOW-ICONS"
></A
>gnome_icon_selection_show_icons ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_icon_selection_show_icons (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);</PRE
></TD
></TR
></TABLE
><P
>Shows the icons inside the widget that
were added with <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DEFAULTS"
>gnome_icon_selection_add_defaults</A
> and
<A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DIRECTORY"
>gnome_icon_selection_add_directory</A
>. Before this function
is called the icons aren't actually added to the listing
and can't be picked by the user.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19546"
></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
>gis</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19555"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-CLEAR"
></A
>gnome_icon_selection_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_icon_selection_clear (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> not_shown);</PRE
></TD
></TR
></TABLE
><P
>Clear the currently shown icons, the ones
that weren't shown yet are not cleared unless the not_shown
parameter is given, in which case even those are cleared.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19563"
></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
>gis</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>not_shown</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19576"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-GET-ICON"
></A
>gnome_icon_selection_get_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>* gnome_icon_selection_get_icon (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> full_path);</PRE
></TD
></TR
></TABLE
><P
>Gets the currently selected icon name, if
full_path is true, it returns the full path to the icon,
if none is selected it returns NULL</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19585"
></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
>gis</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>full_path</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</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"
> internal string, it must not be changed or freed
or NULL</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19602"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-SELECT-ICON"
></A
>gnome_icon_selection_select_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_icon_selection_select_icon
(<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *filename);</PRE
></TD
></TR
></TABLE
><P
>Selects the icon <TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>. This icon must have
already been added and shown * (see <TT
CLASS="PARAMETER"
><I
>gnome_icon_selection_show_icons</I
></TT
>)</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19612"
></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
>gis</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> icon filename</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19625"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> widget; </P
></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="gnomeiconlist.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="gnomeless.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
>GnomeIconList</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeLess</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
462
