Extensions to Gtk+

Extensions to Gtk+ — Miscelleanous extensions to the Gtk+ library

Functions

Includes

#include <exo/exo.h>

Description

Various additional functions to the core API provided by the Gtk+ library.

For example, exo_gtk_file_chooser_add_thumbnail_preview() is a convenience method to add a thumbnail based preview widget to a GtkFileChooser, which will display a preview of the selected file if either a thumbnail is available or a thumbnail could be generated using the GdkPixbuf library.

Functions

exo_gtk_object_destroy_later ()

void
exo_gtk_object_destroy_later (GtkWidget *object);

Schedules an idle function to destroy the specified object when the application enters the main loop the next time.

Parameters

object

a GtkObject.

 

exo_gtk_file_chooser_add_thumbnail_preview ()

void
exo_gtk_file_chooser_add_thumbnail_preview
                               (GtkFileChooser *chooser);

This is a convenience function that adds a preview widget to the chooser , which displays thumbnails for the selected filenames using the thumbnail database. The preview widget is also able to generate thumbnails for all image formats supported by GdkPixbuf.

Use this function whenever you display a GtkFileChooser to ask the user to select an image file from the file system.

The preview widget also supports URIs other than file:-URIs to a certain degree, but this support is rather limited currently, so you may want to use gtk_file_chooser_set_local_only() to ensure that the user can only select files from the local file system.

When chooser is configured to select multiple image files - using the gtk_file_chooser_set_select_multiple() method - the behaviour of the preview widget is currently undefined, in that it is not defined for which of the selected files the preview will be displayed.

Parameters

chooser

a GtkFileChooser.

 

Since: 0.3.1.9


exo_gtk_url_about_dialog_hook ()

void
exo_gtk_url_about_dialog_hook (GtkAboutDialog *about_dialog,
                               const gchar *address,
                               gpointer user_data);

This is a convenience function, which can be registered with GtkAboutDialog, to open links clicked by the user in GtkAboutDialogs.

All you need to do is to register this hook with gtk_about_dialog_set_url_hook() and gtk_about_dialog_set_email_hook(). This can be done prior to calling gtk_show_about_dialog(), for example:

1
2
3
4
5
static void show_about_dialog (void)
{

  gtk_show_about_dialog (.....);
}

This function is not needed when you use Gtk 2.18 or later, because from that version this is implemented by default.

Parameters

about_dialog

the GtkAboutDialog in which the user activated a link.

 

address

the link, mail or web address, to open.

 

user_data

user data that was passed when the function was registered with gtk_about_dialog_set_email_hook() or gtk_about_dialog_set_url_hook(). This is currently unused within the context of this function, so you can safely pass NULL when registering this hook with GtkAboutDialog.

 

Since: 0.5.0


exo_gtk_dialog_get_action_area ()

GtkWidget *
exo_gtk_dialog_get_action_area (GtkDialog *dialog);

Returns the action area of a GtkDialog. The internal function has been deprecated in GTK+, so this wraps and dispels the deprecation warning.

Parameters

dialog

a GtkDialog.

 

Returns

the action area.

Since: 0.11.4


exo_gtk_dialog_add_secondary_button ()

void
exo_gtk_dialog_add_secondary_button (GtkDialog *dialog,
                                     GtkWidget *button);

Convenience function to add a secondary button to a GtkDialog.

Parameters

dialog

a GtkDialog.

 

button

a GtkButton to add and mark as secondary.

 

Since: 0.11.4