GnomeFileEntry

typedef struct _GnomeFileEntry GnomeFileEntry;

gnome_file_entry_new ()

GtkWidget*  gnome_file_entry_new            (const char *history_id,
                                             const char *browse_dialog_title);

Creates a new GnomeFileEntry widget.

gnome_file_entry_construct ()

void        gnome_file_entry_construct      (GnomeFileEntry *fentry,
                                             const char *history_id,
                                             const char *browse_dialog_title);

Constructs a GnomeFileEntry

gnome_file_entry_gnome_entry ()

GtkWidget*  gnome_file_entry_gnome_entry    (GnomeFileEntry *fentry);

It returns a pointer to the gnome entry widget of the widget (seeGnomeEntry).

gnome_file_entry_gtk_entry ()

GtkWidget*  gnome_file_entry_gtk_entry      (GnomeFileEntry *fentry);

Similar to gnome_file_entry_gnome_entry but returns the gtk entry instead of the Gnome entry widget.

gnome_file_entry_set_title ()

void        gnome_file_entry_set_title      (GnomeFileEntry *fentry,
                                             const char *browse_dialog_title);

Set the title of the browse dialog to browse_dialog_title. The new title will go into effect the next time the browse button is pressed.

gnome_file_entry_set_default_path ()

void        gnome_file_entry_set_default_path
                                            (GnomeFileEntry *fentry,
                                             const char *path);

Set the default path of browse dialog to path. 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.

gnome_file_entry_set_directory_entry ()

void        gnome_file_entry_set_directory_entry
                                            (GnomeFileEntry *fentry,
                                             gboolean directory_entry);

Sets whether this is a directory only entry. If directory_entry is true, then gnome_file_entry_get_full_path will check for the file being a directory, and the browse dialog will have the file list disabled.

gnome_file_entry_get_directory_entry ()

gboolean    gnome_file_entry_get_directory_entry
                                            (GnomeFileEntry *fentry);

Gets whether this is a directory only entry. See also gnome_file_entry_set_directory_entry.

gnome_file_entry_get_full_path ()

char*       gnome_file_entry_get_full_path  (GnomeFileEntry *fentry,
                                             gboolean file_must_exist);

Gets the full absolute path of the file from the entry. If file_must_exist is false, nothing is tested and the path is returned. If file_must_exist is true, then the path is only returned if the path actually exists. In case the entry is a directory entry (see gnome_file_entry_set_directory_entry), 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.

gnome_file_entry_set_filename ()

void        gnome_file_entry_set_filename   (GnomeFileEntry *fentry,
                                             const char *filename);

Sets the internal entry to this string.

gnome_file_entry_set_modal ()

void        gnome_file_entry_set_modal      (GnomeFileEntry *fentry,
                                             gboolean is_modal);

Sets the modality of the browse dialog.

gnome_file_entry_get_modal ()

gboolean    gnome_file_entry_get_modal      (GnomeFileEntry *fentry);

This function gets the boolean which specifies if the browsing dialog is modal or not

gnome_file_entry_set_directory ()

void        gnome_file_entry_set_directory  (GnomeFileEntry *fentry,
                                             gboolean directory_entry);

Deprecated, use gnome_file_entry_set_directory_entry

The "browse-dialog-title" property

  "browse-dialog-title"  gchararray            : Read / Write

Title for the Browse file dialog.

Default value: NULL

The "default-path" property

  "default-path"         gchararray            : Read / Write

Default path for the Browse file window.

Default value: NULL

The "directory-entry" property

  "directory-entry"      gboolean              : Read / Write

Whether the file entry is being used to enter directory names or complete filenames.

Default value: FALSE

The "filechooser-action" property

  "filechooser-action"   GtkFileChooserAction  : Read / Write

The type of operation that the file selector is performing.

Default value: GTK_FILE_CHOOSER_ACTION_OPEN

The "filename" property

  "filename"             gchararray            : Read / Write

Filename that should be displayed in the file entry.

Default value: NULL

The "gnome-entry" property

  "gnome-entry"          GnomeEntry            : Read

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.

The "gtk-entry" property

  "gtk-entry"            GtkEntry              : Read

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.

The "history-id" property

  "history-id"           gchararray            : Read / Write

Unique identifier for the file entry. This will be used to save the history list.

Default value: NULL

The "modal" property

  "modal"                gboolean              : Read / Write

Whether the Browse file window should be modal.

Default value: FALSE

The "use-filechooser" property

  "use-filechooser"      gboolean              : Read / Write

Whether to use the new GtkFileChooser widget or the GtkFileSelection widget to select files.

Default value: FALSE

The "activate" signal

void        user_function                  (GnomeFileEntry *fileentry,
                                            gpointer user_data);

The "browse-clicked" signal

void        user_function                  (GnomeFileEntry *fileentry,
                                            gpointer user_data);