|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/libgnomeui/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GnomeFileEntry</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GNOME UI Library Reference Manual">
<link rel="up" href="fixme.html" title="Miscellaneous Widgets">
<link rel="prev" href="GnomeEntry.html" title="GnomeEntry">
<link rel="next" href="GnomeFontPicker.html" title="GnomeFontPicker">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="GNOME UI Library (libgnomeui)">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GnomeEntry.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="fixme.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNOME UI Library Reference Manual</th>
<td><a accesskey="n" href="GnomeFontPicker.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3018124" class="shortcut">Top</a>
 | 
<a href="#id3018910" class="shortcut">Description</a>
 | 
<a href="#id3018529" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id3018609" class="shortcut">Implemented Interfaces</a>
 | 
<a href="#id3018638" class="shortcut">Properties</a>
 | 
<a href="#id3018828" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GnomeFileEntry"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3018124"></a><span class="refentrytitle">GnomeFileEntry</span>
</h2>
<p>GnomeFileEntry — </p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <libgnomeui/libgnomeui.h>
<a href="GnomeFileEntry.html#GnomeFileEntry-struct">GnomeFileEntry</a>;
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GnomeFileEntry.html#gnome-file-entry-new">gnome_file_entry_new</a> (const char *history_id,
const char *browse_dialog_title);
void <a href="GnomeFileEntry.html#gnome-file-entry-construct">gnome_file_entry_construct</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *history_id,
const char *browse_dialog_title);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GnomeFileEntry.html#gnome-file-entry-gnome-entry">gnome_file_entry_gnome_entry</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GnomeFileEntry.html#gnome-file-entry-gtk-entry">gnome_file_entry_gtk_entry</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);
void <a href="GnomeFileEntry.html#gnome-file-entry-set-title">gnome_file_entry_set_title</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const 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" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *path);
void <a href="GnomeFileEntry.html#gnome-file-entry-set-directory-entry">gnome_file_entry_set_directory_entry</a>
(<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> directory_entry);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GnomeFileEntry.html#gnome-file-entry-get-directory-entry">gnome_file_entry_get_directory_entry</a>
(<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);
char* <a href="GnomeFileEntry.html#gnome-file-entry-get-full-path">gnome_file_entry_get_full_path</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> file_must_exist);
void <a href="GnomeFileEntry.html#gnome-file-entry-set-filename">gnome_file_entry_set_filename</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *filename);
void <a href="GnomeFileEntry.html#gnome-file-entry-set-modal">gnome_file_entry_set_modal</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> is_modal);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GnomeFileEntry.html#gnome-file-entry-get-modal">gnome_file_entry_get_modal</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);
void <a href="GnomeFileEntry.html#gnome-file-entry-set-directory">gnome_file_entry_set_directory</a> (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> directory_entry);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3018529"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
>GtkObject</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
>GtkContainer</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkBox.html"
>GtkBox</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkVBox.html"
>GtkVBox</a>
+----GnomeFileEntry
+----<a href="GnomePixmapEntry.html" title="GnomePixmapEntry">GnomePixmapEntry</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3018609"></a><h2>Implemented Interfaces</h2>
<p>
GnomeFileEntry implements
AtkImplementorIface and <a
href="/usr/share/gtk-doc/html/gtk/GtkEditable.html"
>GtkEditable</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="id3018638"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GnomeFileEntry.html#GnomeFileEntry--browse-dialog-title">browse-dialog-title</a>" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--default-path">default-path</a>" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--directory-entry">directory-entry</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--filechooser-action">filechooser-action</a>" <a
href="/usr/share/gtk-doc/html/gtk/GtkFileChooser.html#GtkFileChooserAction"
>GtkFileChooserAction</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--filename">filename</a>" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--gnome-entry">gnome-entry</a>" <a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> : Read
"<a href="GnomeFileEntry.html#GnomeFileEntry--gtk-entry">gtk-entry</a>" <a
href="/usr/share/gtk-doc/html/gtk/GtkEntry.html"
>GtkEntry</a> : Read
"<a href="GnomeFileEntry.html#GnomeFileEntry--history-id">history-id</a>" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--modal">modal</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GnomeFileEntry.html#GnomeFileEntry--use-filechooser">use-filechooser</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3018828"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="GnomeFileEntry.html#GnomeFileEntry-activate">activate</a>" void user_function (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fileentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="GnomeFileEntry.html#GnomeFileEntry-browse-clicked">browse-clicked</a>"
void user_function (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fileentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3018910"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3018925"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3018935"></a><h3>
<a name="GnomeFileEntry-struct"></a>GnomeFileEntry</h3>
<a class="indexterm" name="id3018949"></a><pre class="programlisting">typedef struct _GnomeFileEntry GnomeFileEntry;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GnomeFileEntry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3018977"></a><h3>
<a name="gnome-file-entry-new"></a>gnome_file_entry_new ()</h3>
<a class="indexterm" name="id3018992"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* gnome_file_entry_new (const char *history_id,
const char *browse_dialog_title);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a href="GnomeFileEntry.html" title="GnomeFileEntry"><span class="type">GnomeFileEntry</span></a> widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>history_id</code></em> :</span></td>
<td> the id given to <a href="GnomeEntry.html#gnome-entry-new"><span class="type">gnome_entry_new</span></a> (see <a href="GnomeEntry.html" title="GnomeEntry"><span class="type">GnomeEntry</span></a>).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>browse_dialog_title</code></em> :</span></td>
<td> Title for the file dialog window.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A pointer to the widget, NULL if it cannot be created.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019113"></a><h3>
<a name="gnome-file-entry-construct"></a>gnome_file_entry_construct ()</h3>
<a class="indexterm" name="id3019129"></a><pre class="programlisting">void gnome_file_entry_construct (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *history_id,
const char *browse_dialog_title);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_construct</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Constructs a <a href="GnomeFileEntry.html" title="GnomeFileEntry"><span class="type">GnomeFileEntry</span></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> A <a href="GnomeFileEntry.html" title="GnomeFileEntry"><span class="type">GnomeFileEntry</span></a> to construct.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>history_id</code></em> :</span></td>
<td> the id given to <a href="GnomeEntry.html#gnome-entry-new"><span class="type">gnome_entry_new</span></a> (see <a href="GnomeEntry.html" title="GnomeEntry"><span class="type">GnomeEntry</span></a>).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>browse_dialog_title</code></em> :</span></td>
<td> Title for the file dialog window.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019267"></a><h3>
<a name="gnome-file-entry-gnome-entry"></a>gnome_file_entry_gnome_entry ()</h3>
<a class="indexterm" name="id3019283"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* gnome_file_entry_gnome_entry (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_gnome_entry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
It returns a pointer to the gnome entry widget of the
widget (see<a href="GnomeEntry.html" title="GnomeEntry"><span class="type">GnomeEntry</span></a>).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A pointer to the component <a href="GnomeEntry.html" title="GnomeEntry"><span class="type">GnomeEntry</span></a> widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019374"></a><h3>
<a name="gnome-file-entry-gtk-entry"></a>gnome_file_entry_gtk_entry ()</h3>
<a class="indexterm" name="id3019390"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* gnome_file_entry_gtk_entry (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_gtk_entry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Similar to <a href="GnomeFileEntry.html#gnome-file-entry-gnome-entry"><span class="type">gnome_file_entry_gnome_entry</span></a> but
returns the gtk entry instead of the Gnome entry widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> Returns the GtkEntry widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019474"></a><h3>
<a name="gnome-file-entry-set-title"></a>gnome_file_entry_set_title ()</h3>
<a class="indexterm" name="id3019491"></a><pre class="programlisting">void gnome_file_entry_set_title (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *browse_dialog_title);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_set_title</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the title of the browse dialog to <em class="parameter"><code>browse_dialog_title</code></em>.
The new title will go into effect the next time the browse button is pressed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>browse_dialog_title</code></em> :</span></td>
<td> The new title for the file browse dialog window.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019584"></a><h3>
<a name="gnome-file-entry-set-default-path"></a>gnome_file_entry_set_default_path ()</h3>
<a class="indexterm" name="id3019600"></a><pre class="programlisting">void gnome_file_entry_set_default_path
(<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_set_default_path</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the default path of browse dialog to <em class="parameter"><code>path</code></em>. 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="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> A path string.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019695"></a><h3>
<a name="gnome-file-entry-set-directory-entry"></a>gnome_file_entry_set_directory_entry ()</h3>
<a class="indexterm" name="id3019712"></a><pre class="programlisting">void gnome_file_entry_set_directory_entry
(<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> directory_entry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_set_directory_entry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets whether this is a directory only entry. If
<em class="parameter"><code>directory_entry</code></em> is true, then <a href="GnomeFileEntry.html#gnome-file-entry-get-full-path"><span class="type">gnome_file_entry_get_full_path</span></a> will
check for the file being a directory, and the browse dialog will have
the file list disabled.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>directory_entry</code></em> :</span></td>
<td> boolean
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019816"></a><h3>
<a name="gnome-file-entry-get-directory-entry"></a>gnome_file_entry_get_directory_entry ()</h3>
<a class="indexterm" name="id3019832"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gnome_file_entry_get_directory_entry
(<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_get_directory_entry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Gets whether this is a directory only entry.
See also <a href="GnomeFileEntry.html#gnome-file-entry-set-directory-entry"><span class="type">gnome_file_entry_set_directory_entry</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A boolean.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3019917"></a><h3>
<a name="gnome-file-entry-get-full-path"></a>gnome_file_entry_get_full_path ()</h3>
<a class="indexterm" name="id3019933"></a><pre class="programlisting">char* gnome_file_entry_get_full_path (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> file_must_exist);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_get_full_path</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Gets the full absolute path of the file from the entry.
If <em class="parameter"><code>file_must_exist</code></em> is false, nothing is tested and the path is returned.
If <em class="parameter"><code>file_must_exist</code></em> 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-entry"><span class="type">gnome_file_entry_set_directory_entry</span></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="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>file_must_exist</code></em> :</span></td>
<td> boolean
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a newly allocated string with the path or NULL if something went
wrong
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020058"></a><h3>
<a name="gnome-file-entry-set-filename"></a>gnome_file_entry_set_filename ()</h3>
<a class="indexterm" name="id3020074"></a><pre class="programlisting">void gnome_file_entry_set_filename (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
const char *filename);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_set_filename</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the internal entry to this string.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>filename</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020160"></a><h3>
<a name="gnome-file-entry-set-modal"></a>gnome_file_entry_set_modal ()</h3>
<a class="indexterm" name="id3020176"></a><pre class="programlisting">void gnome_file_entry_set_modal (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> is_modal);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_set_modal</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the modality of the browse dialog.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>is_modal</code></em> :</span></td>
<td> true if the window is to be modal, false otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020261"></a><h3>
<a name="gnome-file-entry-get-modal"></a>gnome_file_entry_get_modal ()</h3>
<a class="indexterm" name="id3020278"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gnome_file_entry_get_modal (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_get_modal</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function gets the boolean which specifies if
the browsing dialog is modal or not</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A boolean.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020352"></a><h3>
<a name="gnome-file-entry-set-directory"></a>gnome_file_entry_set_directory ()</h3>
<a class="indexterm" name="id3020368"></a><pre class="programlisting">void gnome_file_entry_set_directory (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> directory_entry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_file_entry_set_directory</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated, use <a href="GnomeFileEntry.html#gnome-file-entry-set-directory-entry"><span class="type">gnome_file_entry_set_directory_entry</span></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fentry</code></em> :</span></td>
<td> The GnomeFileEntry widget to work with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>directory_entry</code></em> :</span></td>
<td> boolean
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3020463"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3020474"></a><h3>
<a name="GnomeFileEntry--browse-dialog-title"></a>The "<code class="literal">browse-dialog-title</code>" property</h3>
<a class="indexterm" name="id3020491"></a><pre class="programlisting"> "browse-dialog-title" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Title for the Browse file dialog.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020518"></a><h3>
<a name="GnomeFileEntry--default-path"></a>The "<code class="literal">default-path</code>" property</h3>
<a class="indexterm" name="id3020535"></a><pre class="programlisting"> "default-path" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Default path for the Browse file window.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020562"></a><h3>
<a name="GnomeFileEntry--directory-entry"></a>The "<code class="literal">directory-entry</code>" property</h3>
<a class="indexterm" name="id3020578"></a><pre class="programlisting"> "directory-entry" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the file entry is being used to enter directory names or complete filenames.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020606"></a><h3>
<a name="GnomeFileEntry--filechooser-action"></a>The "<code class="literal">filechooser-action</code>" property</h3>
<a class="indexterm" name="id3020623"></a><pre class="programlisting"> "filechooser-action" <a
href="/usr/share/gtk-doc/html/gtk/GtkFileChooser.html#GtkFileChooserAction"
>GtkFileChooserAction</a> : Read / Write</pre>
<p>The type of operation that the file selector is performing.</p>
<p>Default value: GTK_FILE_CHOOSER_ACTION_OPEN</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020651"></a><h3>
<a name="GnomeFileEntry--filename"></a>The "<code class="literal">filename</code>" property</h3>
<a class="indexterm" name="id3020668"></a><pre class="programlisting"> "filename" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Filename that should be displayed in the file entry.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020695"></a><h3>
<a name="GnomeFileEntry--gnome-entry"></a>The "<code class="literal">gnome-entry</code>" property</h3>
<a class="indexterm" name="id3020711"></a><pre class="programlisting"> "gnome-entry" <a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> : Read</pre>
<p>GnomeEntry that the file entry uses for entering filenames. You can use this property to get the GnomeEntry if you need to modify or query any of its parameters.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020736"></a><h3>
<a name="GnomeFileEntry--gtk-entry"></a>The "<code class="literal">gtk-entry</code>" property</h3>
<a class="indexterm" name="id3020753"></a><pre class="programlisting"> "gtk-entry" <a
href="/usr/share/gtk-doc/html/gtk/GtkEntry.html"
>GtkEntry</a> : Read</pre>
<p>GtkEntry that the file entry uses for entering filenames. You can use this property to get the GtkEntry if you need to modify or query any of its parameters.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020778"></a><h3>
<a name="GnomeFileEntry--history-id"></a>The "<code class="literal">history-id</code>" property</h3>
<a class="indexterm" name="id3020794"></a><pre class="programlisting"> "history-id" <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Unique identifier for the file entry. This will be used to save the history list.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020821"></a><h3>
<a name="GnomeFileEntry--modal"></a>The "<code class="literal">modal</code>" property</h3>
<a class="indexterm" name="id3020838"></a><pre class="programlisting"> "modal" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the Browse file window should be modal.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3020865"></a><h3>
<a name="GnomeFileEntry--use-filechooser"></a>The "<code class="literal">use-filechooser</code>" property</h3>
<a class="indexterm" name="id3020882"></a><pre class="programlisting"> "use-filechooser" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether to use the new GtkFileChooser widget or the GtkFileSelection widget to select files.</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3020911"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3020921"></a><h3>
<a name="GnomeFileEntry-activate"></a>The "activate" signal</h3>
<a class="indexterm" name="id3020932"></a><pre class="programlisting">void user_function (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fileentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fileentry</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3021000"></a><h3>
<a name="GnomeFileEntry-browse-clicked"></a>The "browse-clicked" signal</h3>
<a class="indexterm" name="id3021011"></a><pre class="programlisting">void user_function (<a href="GnomeFileEntry.html" title="GnomeFileEntry">GnomeFileEntry</a> *fileentry,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>fileentry</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>