![]() |
![]() |
![]() |
exo Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <exo/exo.h> void exo_gtk_object_destroy_later (GtkObject *object); gpointer exo_gtk_object_ref_sink (GtkObject *object); void exo_gtk_radio_action_set_current_value (GtkRadioAction *action, gint current_value); void exo_gtk_file_chooser_add_thumbnail_preview (GtkFileChooser *chooser);
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.
void exo_gtk_object_destroy_later (GtkObject *object);
Schedules an idle function to destroy the specified object
when the application enters the main loop the next time.
|
a GtkObject. |
gpointer exo_gtk_object_ref_sink (GtkObject *object);
Helper function used to take a reference on
object
and droppping the floating reference
to object
(if any) atomically.
If libexo is compiled against Gtk+ 2.9.0 or
newer, this function will use g_object_ref_sink()
,
since with newer Gtk+/GObject versions, the floating
reference handling was moved to GObject. Else, this
function will expand to
g_object_ref (G_OBJECT (object)); gtk_object_sink (GTK_OBJECT (object));
The caller is responsible to release the reference
on object
acquire by this function call using
g_object_unref()
.
|
a GtkObject. |
Returns : |
a reference to object .
|
void exo_gtk_radio_action_set_current_value (GtkRadioAction *action, gint current_value);
Looks for all actions in the group to which action
belongs and if
any of the actions matches the current_value
, it will become the
new active action.
Else if none of the actions in action
's radio group match
the specified current_value
, all actions will be deactivated and
the radio group will have no active action afterwards.
|
A GtkRadioAction. |
|
the value of the GtkRadioAction to activate. |
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.
|
a GtkFileChooser. |
Since 0.3.1.9