<HTML
><HEAD
><TITLE
>GnomeFileEntry</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="GnomeEntry"
HREF="gnomeentry.html"><LINK
REL="NEXT"
TITLE="GnomeFontPicker"
HREF="gnomefontpicker.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="gnomeentry.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="gnomefontpicker.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEFILEENTRY"
>GnomeFileEntry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN17272"
></A
><H2
>Name</H2
>GnomeFileEntry -- An entry widget for file names.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN17275"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> #include <gnome.h>
struct <A
HREF="gnomefileentry.html#GNOMEFILEENTRY-STRUCT"
>GnomeFileEntry</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-NEW"
>gnome_file_entry_new</A
> (char *history_id,
char *browse_dialog_title);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GNOME-ENTRY"
>gnome_file_entry_gnome_entry</A
> (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GTK-ENTRY"
>gnome_file_entry_gtk_entry</A
> (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);
void <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-TITLE"
>gnome_file_entry_set_title</A
> (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
char *browse_dialog_title);
void <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-DEFAULT-PATH"
>gnome_file_entry_set_default_path</A
>
(<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
char *path);
void <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-DIRECTORY"
>gnome_file_entry_set_directory</A
> (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
int directory_entry);
char* <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GET-FULL-PATH"
>gnome_file_entry_get_full_path</A
> (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
int file_must_exist);
void <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-MODAL"
>gnome_file_entry_set_modal</A
> (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
int is_modal); </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17297"
></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="GTKHBOX"
>GtkHBox</GTKDOCLINK
>
+----GnomeFileEntry</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17305"
></A
><H2
>Description</H2
><P
> This widget provides an entry box with history (a <A
HREF="gnomeentry.html"
>GnomeEntry</A
>) and a
button which can pop up a file selector dialog box
(GtkFileSelection). It also accepts DND drops from the filemanager
and other sources.</P
><P
>The following is an example of its use. It is a collection of excerpts
from the sound section of the GNOME control center.</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN17310"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static SoundProps *
sound_properties_create(void)
{
char *path;
GtkWidget *btn_filename;
SoundProps *retval;
...
/* Create the gnome_file_entry widget, with a given title */
btn_filename = gnome_file_entry_new(NULL, _("Select sound file"));
/* sets the default path */
path = gnome_datadir_file ("sounds/");
gnome_file_entry_set_default_path(GNOME_FILE_ENTRY (retval->btn_filename), path);
/* Connect the function sound_properties_event_change_file to the
event "changed" of the entry widget of gnome_file_entry. The
function will be called with a pointer to the entry widget in the
gnome_file_entry and the "retval" value. Look at
sound_properties_event_change_file below. */
gtk_signal_connect(GTK_OBJECT(gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(btn_filename))),
"changed",
GTK_SIGNAL_FUNC(sound_properties_event_change_file),
retval);
...
}
...
/* This is the callback function for the "changed" event of the
gnome_file_entry. */
static void
sound_properties_event_change_file(GtkEditable *entry, SoundProps *props)
{
char *tmp, *sounddir, *tmp2;
...
/* Get the current value of the gnome_file_entry */
tmp = gtk_entry_get_text(GTK_ENTRY(entry));
...
}
...
static void
sound_properties_event_play(GtkWidget *widget, SoundProps *props)
{
GtkWidget *entry;
/* This code shows how to read the current value of the widget,
you first have to get a pointer to the entry widget of the
gnome_file_entry*/
entry = gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(props->btn_filename));
gnome_sound_play(gtk_entry_get_text(GTK_ENTRY(entry)));
}
...
/* This is the way that you set the value of the widget */
GtkWidget *btn_filename;
gtk_entry_set_text(GTK_ENTRY(gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(btn_filename))),
ctmp);
</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17312"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17314"
></A
><H3
><A
NAME="GNOMEFILEENTRY-STRUCT"
></A
>struct GnomeFileEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeFileEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17319"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-NEW"
></A
>gnome_file_entry_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* gnome_file_entry_new (char *history_id,
char *browse_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17327"
></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
> (see <A
HREF="gnomeentry.html"
>GnomeEntry</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 for the file dialog window.</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 pointer to the widget, NULL if it cannot be created.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17346"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-GNOME-ENTRY"
></A
>gnome_file_entry_gnome_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* gnome_file_entry_gnome_entry (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);</PRE
></TD
></TR
></TABLE
><P
>It returns a pointer to the gnome entry widget of the
widget (see<A
HREF="gnomeentry.html"
>GnomeEntry</A
>).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17355"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget 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 pointer to the component <A
HREF="gnomeentry.html"
>GnomeEntry</A
> widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17369"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-GTK-ENTRY"
></A
>gnome_file_entry_gtk_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>* gnome_file_entry_gtk_entry (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);</PRE
></TD
></TR
></TABLE
><P
>Similar to <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GNOME-ENTRY"
>gnome_file_entry_gnome_entry</A
> but
returns the gtk entry instead of the Gnome entry widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17378"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget 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 the GtkEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17391"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-TITLE"
></A
>gnome_file_entry_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_file_entry_set_title (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
char *browse_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Set the title of the browse dialog to <TT
CLASS="PARAMETER"
><I
>browse_dialog_title</I
></TT
>.
The new title will go into effect the next time the browse button is pressed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17399"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</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"
> The new title for the file browse dialog window.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17412"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-DEFAULT-PATH"
></A
>gnome_file_entry_set_default_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_file_entry_set_default_path
(<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
char *path);</PRE
></TD
></TR
></TABLE
><P
>Set the default path of browse dialog to <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>. The
default path is only used if the entry is empty or if the current path
of the entry is not an absolute path, in which case the default
path is prepended to it before the dialog is started.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17420"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A path string.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17433"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-DIRECTORY"
></A
>gnome_file_entry_set_directory ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_file_entry_set_directory (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
int directory_entry);</PRE
></TD
></TR
></TABLE
><P
>Sets whether this is a directory only entry. If
<TT
CLASS="PARAMETER"
><I
>directory_entry</I
></TT
> is true, then <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GET-FULL-PATH"
>gnome_file_entry_get_full_path</A
> will
check for the file being a directory, and the browse dialog will have
the file list disabled.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17442"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>directory_entry</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="AEN17455"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-GET-FULL-PATH"
></A
>gnome_file_entry_get_full_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char* gnome_file_entry_get_full_path (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
int file_must_exist);</PRE
></TD
></TR
></TABLE
><P
>Gets the full absolute path of the file from the entry.
If <TT
CLASS="PARAMETER"
><I
>file_must_exist</I
></TT
> is false, nothing is tested and the path is returned.
If <TT
CLASS="PARAMETER"
><I
>file_must_exist</I
></TT
> is true, then the path is only returned if the path
actually exists. In case the entry is a directory entry (see
<A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-DIRECTORY"
>gnome_file_entry_set_directory</A
>), then if the path exists and is a
directory then it's returned; if not, it is assumed it was a file so
we try to strip it, and try again. It allocates memory for the returned string.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17465"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file_must_exist</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"
> a newly allocated string with the path or NULL if something went
wrong</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17482"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-MODAL"
></A
>gnome_file_entry_set_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_file_entry_set_modal (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
int is_modal);</PRE
></TD
></TR
></TABLE
><P
>Sets the modality of the browse dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17489"
></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
>fentry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>is_modal</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> true if the window is to be modal, false otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17502"
></A
><H2
>See Also</H2
><P
> <A
HREF="gnomeentry.html"
>GnomeEntry</A
>, <A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
>, <A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
>, <A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</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="gnomeentry.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="gnomefontpicker.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
>GnomeEntry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeFontPicker</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
