Gnome User Interface Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gnome.h> struct GnomeIconSelection; GtkWidget* gnome_icon_selection_new (void); void gnome_icon_selection_add_defaults (GnomeIconSelection *gis); void gnome_icon_selection_add_directory (GnomeIconSelection *gis, const gchar *dir); void gnome_icon_selection_show_icons (GnomeIconSelection *gis); void gnome_icon_selection_clear (GnomeIconSelection *gis, gboolean not_shown); const gchar* gnome_icon_selection_get_icon (GnomeIconSelection *gis, gboolean full_path); void gnome_icon_selection_select_icon (GnomeIconSelection *gis, const gchar *filename); |
GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GnomeIconSelection |
GtkWidget* gnome_icon_selection_new (void); |
Creates a new icon selection widget, it uses GnomeIconList for the listing of icons
Returns : | Returns the new object |
void gnome_icon_selection_add_defaults (GnomeIconSelection *gis); |
Adds the default pixmap directory into the selection widget. It doesn't show the icons in the selection until you do gnome_icon_selection_show_icons.
gis : | GnomeIconSelection to work with |
void gnome_icon_selection_add_directory (GnomeIconSelection *gis, const gchar *dir); |
Adds the icons from the directory dir to the selection widget. It doesn't show the icons in the selection until you do gnome_icon_selection_show_icons.
gis : | GnomeIconSelection to work with |
dir : | directory with pixmaps |
void gnome_icon_selection_show_icons (GnomeIconSelection *gis); |
Shows the icons inside the widget that were added with gnome_icon_selection_add_defaults and gnome_icon_selection_add_directory. Before this function is called the icons aren't actually added to the listing and can't be picked by the user.
gis : | GnomeIconSelection to work with |
void gnome_icon_selection_clear (GnomeIconSelection *gis, gboolean not_shown); |
Clear the currently shown icons, the ones that weren't shown yet are not cleared unless the not_shown parameter is given, in which case even those are cleared.
gis : | GnomeIconSelection to work with |
not_shown : | boolean |
const gchar* gnome_icon_selection_get_icon (GnomeIconSelection *gis, gboolean full_path); |
Gets the currently selected icon name, if full_path is true, it returns the full path to the icon, if none is selected it returns NULL
gis : | GnomeIconSelection to work with |
full_path : | boolean |
Returns : | internal string, it must not be changed or freed or NULL |
void gnome_icon_selection_select_icon (GnomeIconSelection *gis, const gchar *filename); |
Selects the icon filename. This icon must have already been added and shown * (see gnome_icon_selection_show_icons)
gis : | GnomeIconSelection to work with |
filename : | icon filename |