Gnome2::FileEntry(3)

📦
version 1.048 · 2 versions
, in fedora 43

💖 Gnome2::FileEntry — the perl wrapper glow-up 💖

okay bestie, so this is Gnome2::FileEntry(3), and it lives in the User Contributed Perl Documentation section, which is giving ✨community-made✨ and we love that for us. It's a wrapper for GnomeFileEntry — literally just a lil perl-friendly hug around the C thing. 🫶

🌸 NAME 🌸

Gnome2::FileEntry — it's the wrapper for GnomeFileEntry, no cap.

🦋 HIERARCHY 🦋

here's the family tree, and yes it's a long one, it's giving ancestry.com 💅

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Box
                           +----Gtk2::VBox
                                +----Gnome2::FileEntry

so like, it inherits from everything up that chain. main character lineage fr.

🎀 INTERFACES 🎀

these are the vibes it also carries, the extra fits it can wear:

  • Glib::Object::_Unregistered::AtkImplementorIface
  • Gtk2::Buildable
  • Gtk2::Orientable
  • Gtk2::Editable

✨ METHODS ✨

🌈 widget = Gnome2::FileEntry->new ($history_id, $browse_dialog_title)

the constructor, the birth of a whole new file entry, iconic behavior honestly.

  • $history_id (string) — a string, that's the tea.
  • $browse_dialog_title (string) — also a string bestie.

💜 $fentry->set_default_path ($path)

sets the default path.

  • $path (string)

🌸 boolean = $fentry->get_directory_entry

💅 $fentry->set_directory_entry ($directory_entry)

get and set the directory-entry thing, cute lil pair.

  • $directory_entry (boolean)

🍓 $fentry->set_filename ($filename)

sets the filename.

  • $filename (string)

🦋 string = $fentry->get_full_path ($file_must_exist)

grabs the whole entire path for you. slay.

  • $file_must_exist (boolean)

👑 widget = $fentry->gnome_entry

returns a widget, the GnomeEntry one, that's it that's the method.

👑 widget = $fentry->gtk_entry

same energy, but the GtkEntry one.

💀 boolean = $fentry->get_modal

💀 $fentry->set_modal ($is_modal)

get/set whether it's modal. dramatic popup energy.

  • $is_modal (boolean)

⭐ $fentry->set_title ($browse_dialog_title)

sets the title of the browse dialog.

  • $browse_dialog_title (string)

🧚 PROPERTIES 🧚

these are the properties, all listed, no skipping, we don't do that here. 💖

  • 'browse-dialog-title' (string : default undef : readable / writable) — Title for the Browse file dialog.
  • 'default-path' (string : default undef : readable / writable) — Default path for the Browse file window.
  • 'directory-entry' (boolean : default false : readable / writable) — Whether the file entry is being used to enter directory names or complete filenames.
  • 'filechooser-action' (Gtk2::FileChooserAction : default "open" : readable / writable) — The type of operation that the file selector is performing.
  • 'filename' (string : default undef : readable / writable) — Filename that should be displayed in the file entry.
  • 'gnome-entry' (Gnome2::Entry : default undef : readable) — 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.
  • 'gtk-entry' (Gtk2::Entry : default undef : readable) — 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.
  • 'history-id' (string : default undef : readable / writable) — Unique identifier for the file entry. This will be used to save the history list.
  • 'modal' (boolean : default false : readable / writable) — Whether the Browse file window should be modal.
  • 'use-filechooser' (boolean : default false : readable / writable) — Whether to use the new GtkFileChooser widget or the GtkFileSelection widget to select files.

🔥 SIGNALS 🔥

the two signals, short and sweet:

  • activate (Gnome2::FileEntry)
  • browse-clicked (Gnome2::FileEntry)

🌈 ENUMS AND FLAGS 🌈

🌟 enum Gtk2::FileChooserAction

  • 'open' / GTK_FILE_CHOOSER_ACTION_OPEN
  • 'save' / GTK_FILE_CHOOSER_ACTION_SAVE
  • 'select-folder' / GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER
  • 'create-folder' / GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER

👀 SEE ALSO 👀

go read these too, they're the besties of this page:

Gnome2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Box, Gtk2::VBox

Copyright (C) 2003-2004 by the gtk2-perl team.

This software is licensed under the LGPL. See Gnome2 for a full notice.

okay that's the whole page bestie, every single flag and property accounted for, we left nothing behind, periodt. 💅

this was perl v5.42.0, dated 2025-07-25, and it's Gnome2::FileEntry(3) — mwah, go forth and browse your files, you absolute icon 🎀✨🦋

📦 where this page comes from