<HTML ><HEAD ><TITLE >GnomeIconEntry</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="GnomeHRef" HREF="gnomehref.html"><LINK REL="NEXT" TITLE="GnomeIconTextItem" HREF="gnomeicontextitem.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="gnomehref.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="gnomeicontextitem.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOMEICONENTRY" >GnomeIconEntry</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN18156" ></A ><H2 >Name</H2 >GnomeIconEntry -- A widget to select an icon.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN18159" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> struct <A HREF="gnomeiconentry.html#GNOMEICONENTRY-STRUCT" >GnomeIconEntry</A >; <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-NEW" >gnome_icon_entry_new</A > (char *history_id, char *browse_dialog_title); void <A HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-SET-PIXMAP-SUBDIR" >gnome_icon_entry_set_pixmap_subdir</A > (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry, const char *subdir); <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GNOME-FILE-ENTRY" >gnome_icon_entry_gnome_file_entry</A > (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry); <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GNOME-ENTRY" >gnome_icon_entry_gnome_entry</A > (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry); <GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* <A HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GTK-ENTRY" >gnome_icon_entry_gtk_entry</A > (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry); char* <A HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GET-FILENAME" >gnome_icon_entry_get_filename</A > (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN18178" ></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 > +----GnomeIconEntry</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN18186" ></A ><H2 >Description</H2 ><P > This widget provides the facilities to select an icon. An icon is displayed inside a button, when the button is pressed, an Icon selector (a dialog with a <GTKDOCLINK HREF="GNOMEICONSEL" >GnomeIconSel</GTKDOCLINK > widget) pops up to let the user choose an icon. It also allows one to Drag and Drop the images to and from the preview button.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN18190" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN18192" ></A ><H3 ><A NAME="GNOMEICONENTRY-STRUCT" ></A >struct GnomeIconEntry</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >struct GnomeIconEntry;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN18197" ></A ><H3 ><A NAME="GNOME-ICON-ENTRY-NEW" ></A >gnome_icon_entry_new ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_icon_entry_new (char *history_id, char *browse_dialog_title);</PRE ></TD ></TR ></TABLE ><P >Creates a new icon entry widget</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN18204" ></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 >history_id</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the id given to <A HREF="gnomeentry.html#GNOME-ENTRY-NEW" >gnome_entry_new</A ></TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >browse_dialog_title</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > title of the browse dialog and icon selection dialog</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" > Returns the new object</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN18222" ></A ><H3 ><A NAME="GNOME-ICON-ENTRY-SET-PIXMAP-SUBDIR" ></A >gnome_icon_entry_set_pixmap_subdir ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_icon_entry_set_pixmap_subdir (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry, const char *subdir);</PRE ></TD ></TR ></TABLE ><P >Sets the subdirectory below gnome's default pixmap directory to use as the default path for the file entry.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN18229" ></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 >ientry</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the GnomeIconEntry to work with</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >subdir</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > subdirectory</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN18242" ></A ><H3 ><A NAME="GNOME-ICON-ENTRY-GNOME-FILE-ENTRY" ></A >gnome_icon_entry_gnome_file_entry ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_icon_entry_gnome_file_entry (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry);</PRE ></TD ></TR ></TABLE ><P >Get the GnomeFileEntry widget that's part of the entry</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN18250" ></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 >ientry</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the GnomeIconEntry to work with</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" > Returns GnomeFileEntry widget</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN18263" ></A ><H3 ><A NAME="GNOME-ICON-ENTRY-GNOME-ENTRY" ></A >gnome_icon_entry_gnome_entry ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_icon_entry_gnome_entry (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry);</PRE ></TD ></TR ></TABLE ><P >Get the GnomeEntry widget that's part of the entry</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN18271" ></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 >ientry</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the GnomeIconEntry to work with</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" > Returns GnomeEntry widget</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN18284" ></A ><H3 ><A NAME="GNOME-ICON-ENTRY-GTK-ENTRY" ></A >gnome_icon_entry_gtk_entry ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GTKWIDGET" >GtkWidget</GTKDOCLINK >* gnome_icon_entry_gtk_entry (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry);</PRE ></TD ></TR ></TABLE ><P >Get the GtkEntry widget that's part of the entry</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN18292" ></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 >ientry</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the GnomeIconEntry to work with</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" > Returns GtkEntry widget</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN18305" ></A ><H3 ><A NAME="GNOME-ICON-ENTRY-GET-FILENAME" ></A >gnome_icon_entry_get_filename ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_icon_entry_get_filename (<A HREF="gnomeiconentry.html" >GnomeIconEntry</A > *ientry);</PRE ></TD ></TR ></TABLE ><P >Gets the file name of the image if it was possible to load it into the preview. That is, it will only return a filename if the image exists and it was possible to load it as an image.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN18312" ></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 >ientry</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the GnomeIconEntry to work with</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" > a newly allocated string with the path or <TT CLASS="LITERAL" >NULL</TT > if it couldn't load the file</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN18326" ></A ><H2 >See Also</H2 ><P > <A HREF="gnomeentry.html" >GnomeEntry</A >, <A HREF="gnomefileentry.html" >GnomeFileEntry</A >, <A HREF="gnomenumberentry.html" >GnomeNumberEntry</A >, <A HREF="gnomepixmapentry.html" >GnomePixmapEntry</A ></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="gnomehref.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="gnomeicontextitem.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 >GnomeHRef</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GnomeIconTextItem</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >