Gtk2::Ex::DesktopEntryMenu(3pm)

NAME

Gtk2::Ex::DesktopEntryMenu - Generate menu items to open files

SYNOPSIS

        use Gtk2::Ex::DesktopEntryMenu style => 'auto';
        sub on_populate_popup {
                # ...
                Gtk2::Ex::DesktopEntryMenu->populate_menu($menu, $hyperlink)
                        if $hyperlink =~ m#^file://# ;
                # ..
        }

DESCRIPTION

This module offers an "open with" menu and a simple editor dialog to allow users to open a file with an application that can handle it.

This is a GUI wrapper for "File::MimeInfo::Applications".

TODO: add Dialog to select application or set custom command

TODO: win32 exec code

TODO: way to force using magic

OPTIONS

There is one option which can be given with the "use" statement.

This is the style option. The style can be either "plain", "menu" or "auto". When not given it defaults to "auto". When the style is "plain" all items are included in the menu, when the style is "menu" all items are put in a "Open With" submenu. In the case of "auto" the items are put into a submenu when there are more than 4 applications.

METHODS

"populate_menu(MENU, FILE, MIMETYPE, STYLE)"

Convenience method that adds all applictions that can open this file to the menu.

MENU should be of class Gtk2::Menu. MIMETYPE is optional and FILE can either be a filename or an array reference with filenames.

STYLE can be used to override the default style.

"menuitems(FILE, MIMETYPE)"

Returns a list with Gtk2::MenuItem objects for FILE with MIMETYPE.

MIMETYPE is optional and FILE can either be a filename or an array reference with filenames.

"menuitem(ENTRY, FILE, IS_DEFAULT)"

Returns a Gtk2::MenuItem object for a File::DesktopEntry object that opens FILE when activated.

IS_DEFAULT can be used to tell that this is the default application.

"icon_pixbuf(NAME, SIZE)": Returns a pixbuf for the application icon or undef. NAME can either be a full file name, a partial file name or just the name of something in the theme directories. SIZE is a Gtk2::IconSize name.

AUTHOR

Jaap Karssenberg (Pardus) <[email protected]>