GnomeIconList

Name

GnomeIconList -- 

Synopsis


#include <libgnomeui/libgnomeui.h>


struct      GnomeIconListPrivate;
enum        GnomeIconListMode;
struct      GnomeIconList;
GtkWidget*  gnome_icon_list_new             (guint icon_width,
                                             GtkAdjustment *adj,
                                             int flags);
void        gnome_icon_list_construct       (GnomeIconList *gil,
                                             guint icon_width,
                                             GtkAdjustment *adj,
                                             int flags);
void        gnome_icon_list_set_hadjustment (GnomeIconList *gil,
                                             GtkAdjustment *hadj);
void        gnome_icon_list_set_vadjustment (GnomeIconList *gil,
                                             GtkAdjustment *vadj);
void        gnome_icon_list_freeze          (GnomeIconList *gil);
void        gnome_icon_list_thaw            (GnomeIconList *gil);
void        gnome_icon_list_insert          (GnomeIconList *gil,
                                             int pos,
                                             const char *icon_filename,
                                             const char *text);
void        gnome_icon_list_insert_pixbuf   (GnomeIconList *gil,
                                             int pos,
                                             GdkPixbuf *im,
                                             const char *icon_filename,
                                             const char *text);
int         gnome_icon_list_append          (GnomeIconList *gil,
                                             const char *icon_filename,
                                             const char *text);
int         gnome_icon_list_append_pixbuf   (GnomeIconList *gil,
                                             GdkPixbuf *im,
                                             const char *icon_filename,
                                             const char *text);
void        gnome_icon_list_clear           (GnomeIconList *gil);
void        gnome_icon_list_remove          (GnomeIconList *gil,
                                             int pos);
guint       gnome_icon_list_get_num_icons   (GnomeIconList *gil);
GtkSelectionMode gnome_icon_list_get_selection_mode
                                            (GnomeIconList *gil);
void        gnome_icon_list_set_selection_mode
                                            (GnomeIconList *gil,
                                             GtkSelectionMode mode);
void        gnome_icon_list_select_icon     (GnomeIconList *gil,
                                             int pos);
void        gnome_icon_list_unselect_icon   (GnomeIconList *gil,
                                             int pos);
int         gnome_icon_list_unselect_all    (GnomeIconList *gil);
GList*      gnome_icon_list_get_selection   (GnomeIconList *gil);
void        gnome_icon_list_focus_icon      (GnomeIconList *gil,
                                             gint idx);
void        gnome_icon_list_set_icon_width  (GnomeIconList *gil,
                                             int w);
void        gnome_icon_list_set_row_spacing (GnomeIconList *gil,
                                             int pixels);
void        gnome_icon_list_set_col_spacing (GnomeIconList *gil,
                                             int pixels);
void        gnome_icon_list_set_text_spacing
                                            (GnomeIconList *gil,
                                             int pixels);
void        gnome_icon_list_set_icon_border (GnomeIconList *gil,
                                             int pixels);
void        gnome_icon_list_set_separators  (GnomeIconList *gil,
                                             const char *sep);
gchar*      gnome_icon_list_get_icon_filename
                                            (GnomeIconList *gil,
                                             int idx);
int         gnome_icon_list_find_icon_from_filename
                                            (GnomeIconList *gil,
                                             const char *filename);
void        gnome_icon_list_set_icon_data   (GnomeIconList *gil,
                                             int idx,
                                             gpointer data);
void        gnome_icon_list_set_icon_data_full
                                            (GnomeIconList *gil,
                                             int pos,
                                             gpointer data,
                                             GDestroyNotify destroy);
int         gnome_icon_list_find_icon_from_data
                                            (GnomeIconList *gil,
                                             gpointer data);
gpointer    gnome_icon_list_get_icon_data   (GnomeIconList *gil,
                                             int pos);
void        gnome_icon_list_moveto          (GnomeIconList *gil,
                                             int pos,
                                             double yalign);
GtkVisibility gnome_icon_list_icon_is_visible
                                            (GnomeIconList *gil,
                                             int pos);
int         gnome_icon_list_get_icon_at     (GnomeIconList *gil,
                                             int x,
                                             int y);
int         gnome_icon_list_get_items_per_line
                                            (GnomeIconList *gil);
GnomeIconTextItem* gnome_icon_list_get_icon_text_item
                                            (GnomeIconList *gil,
                                             int idx);
GnomeCanvasPixbuf* gnome_icon_list_get_icon_pixbuf_item
                                            (GnomeIconList *gil,
                                             int idx);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkLayout
                           +----GnomeCanvas
                                 +----GnomeIconList

Signal Prototypes


"focus-icon"
            void        user_function      (GnomeIconList *iconlist,
                                            gint arg1,
                                            gpointer user_data);
"move-cursor"
            void        user_function      (GnomeIconList *iconlist,
                                            GtkDirectionType arg1,
                                            gboolean arg2,
                                            gpointer user_data);
"select-icon"
            void        user_function      (GnomeIconList *iconlist,
                                            gint arg1,
                                            GdkEvent *event,
                                            gpointer user_data);
"text-changed"
            gboolean    user_function      (GnomeIconList *iconlist,
                                            gint arg1,
                                            gchar *arg2,
                                            gpointer user_data);
"toggle-cursor-selection"
            void        user_function      (GnomeIconList *iconlist,
                                            gpointer user_data);
"unselect-icon"
            void        user_function      (GnomeIconList *iconlist,
                                            gint arg1,
                                            GdkEvent *event,
                                            gpointer user_data);

Description

Details

struct GnomeIconListPrivate

struct GnomeIconListPrivate;


enum GnomeIconListMode

typedef enum {
	GNOME_ICON_LIST_ICONS,
	GNOME_ICON_LIST_TEXT_BELOW,
	GNOME_ICON_LIST_TEXT_RIGHT
} GnomeIconListMode;


struct GnomeIconList

struct GnomeIconList;


gnome_icon_list_new ()

GtkWidget*  gnome_icon_list_new             (guint icon_width,
                                             GtkAdjustment *adj,
                                             int flags);

Creates a new icon list widget. The icon columns are allocated a width of icon_width pixels. Icon captions will be word-wrapped to this width as well.

If flags has the GNOME_ICON_LIST_IS_EDITABLE flag set, then the user will be able to edit the text in the icon captions, and the "text_changed" signal will be emitted when an icon's text is changed.

If flags has the GNOME_ICON_LIST_STATIC_TEXT flags set, then the text for the icon captions will not be copied inside the icon list; it will only store the pointers to the original text strings specified by the application. This is intended to save memory. If this flag is not set, then the text strings will be copied and managed internally.


gnome_icon_list_construct ()

void        gnome_icon_list_construct       (GnomeIconList *gil,
                                             guint icon_width,
                                             GtkAdjustment *adj,
                                             int flags);

Constructor for the icon list, to be used by derived classes.


gnome_icon_list_set_hadjustment ()

void        gnome_icon_list_set_hadjustment (GnomeIconList *gil,
                                             GtkAdjustment *hadj);

Sets the adjustment to be used for horizontal scrolling. This is normally not required, as the icon list can be simply inserted in a &GtkScrolledWindow and scrolling will be handled automatically.


gnome_icon_list_set_vadjustment ()

void        gnome_icon_list_set_vadjustment (GnomeIconList *gil,
                                             GtkAdjustment *vadj);

Sets the adjustment to be used for vertical scrolling. This is normally not required, as the icon list can be simply inserted in a &GtkScrolledWindow and scrolling will be handled automatically.


gnome_icon_list_freeze ()

void        gnome_icon_list_freeze          (GnomeIconList *gil);

Freezes an icon list so that any changes made to it will not be reflected on the screen until it is thawed with gnome_icon_list_thaw(). It is recommended to freeze the icon list before inserting or deleting many icons, for example, so that the layout process will only be executed once, when the icon list is finally thawed.

You can call this function multiple times, but it must be balanced with the same number of calls to gnome_icon_list_thaw() before the changes will take effect.


gnome_icon_list_thaw ()

void        gnome_icon_list_thaw            (GnomeIconList *gil);

Thaws the icon list and performs any pending layout operations. This is to be used in conjunction with gnome_icon_list_freeze().


gnome_icon_list_insert ()

void        gnome_icon_list_insert          (GnomeIconList *gil,
                                             int pos,
                                             const char *icon_filename,
                                             const char *text);

Inserts an icon in the specified icon list. The icon's image is loaded from the specified file, and it is inserted at the pos index.


gnome_icon_list_insert_pixbuf ()

void        gnome_icon_list_insert_pixbuf   (GnomeIconList *gil,
                                             int pos,
                                             GdkPixbuf *im,
                                             const char *icon_filename,
                                             const char *text);

Inserts an icon in the specified icon list. The icon is created from the specified Imlib image, and it is inserted at the pos index.


gnome_icon_list_append ()

int         gnome_icon_list_append          (GnomeIconList *gil,
                                             const char *icon_filename,
                                             const char *text);

Appends an icon to the specified icon list. The icon's image is loaded from the specified file, and it is inserted at the pos index.


gnome_icon_list_append_pixbuf ()

int         gnome_icon_list_append_pixbuf   (GnomeIconList *gil,
                                             GdkPixbuf *im,
                                             const char *icon_filename,
                                             const char *text);

Appends an icon to the specified icon list. The icon is created from the specified Imlib image.


gnome_icon_list_clear ()

void        gnome_icon_list_clear           (GnomeIconList *gil);

Clears the contents for the icon list by removing all the icons. If destroy handlers were specified for any of the icons, they will be called with the appropriate data.


gnome_icon_list_remove ()

void        gnome_icon_list_remove          (GnomeIconList *gil,
                                             int pos);

Removes the icon at index position pos. If a destroy handler was specified for that icon, it will be called with the appropriate data.


gnome_icon_list_get_num_icons ()

guint       gnome_icon_list_get_num_icons   (GnomeIconList *gil);


gnome_icon_list_get_selection_mode ()

GtkSelectionMode gnome_icon_list_get_selection_mode
                                            (GnomeIconList *gil);


gnome_icon_list_set_selection_mode ()

void        gnome_icon_list_set_selection_mode
                                            (GnomeIconList *gil,
                                             GtkSelectionMode mode);

Sets the selection mode for an icon list. The GTK_SELECTION_MULTIPLE and GTK_SELECTION_EXTENDED modes are considered equivalent.


gnome_icon_list_select_icon ()

void        gnome_icon_list_select_icon     (GnomeIconList *gil,
                                             int pos);

Selects the icon at the index specified by pos.


gnome_icon_list_unselect_icon ()

void        gnome_icon_list_unselect_icon   (GnomeIconList *gil,
                                             int pos);

Unselects the icon at the index specified by pos.


gnome_icon_list_unselect_all ()

int         gnome_icon_list_unselect_all    (GnomeIconList *gil);


gnome_icon_list_get_selection ()

GList*      gnome_icon_list_get_selection   (GnomeIconList *gil);


gnome_icon_list_focus_icon ()

void        gnome_icon_list_focus_icon      (GnomeIconList *gil,
                                             gint idx);


gnome_icon_list_set_icon_width ()

void        gnome_icon_list_set_icon_width  (GnomeIconList *gil,
                                             int w);

Sets the amount of horizontal space allocated to the icons, i.e. the column width of the icon list.


gnome_icon_list_set_row_spacing ()

void        gnome_icon_list_set_row_spacing (GnomeIconList *gil,
                                             int pixels);

Sets the spacing to be used between rows of icons.


gnome_icon_list_set_col_spacing ()

void        gnome_icon_list_set_col_spacing (GnomeIconList *gil,
                                             int pixels);

Sets the spacing to be used between columns of icons.


gnome_icon_list_set_text_spacing ()

void        gnome_icon_list_set_text_spacing
                                            (GnomeIconList *gil,
                                             int pixels);

Sets the spacing to be used between an icon's image and its text caption.


gnome_icon_list_set_icon_border ()

void        gnome_icon_list_set_icon_border (GnomeIconList *gil,
                                             int pixels);

Sets the width of the border to be displayed around an icon's image. This is currently not implemented.


gnome_icon_list_set_separators ()

void        gnome_icon_list_set_separators  (GnomeIconList *gil,
                                             const char *sep);

Sets the characters that can be used as word separators when doing word-wrapping in the icon text captions.


gnome_icon_list_get_icon_filename ()

gchar*      gnome_icon_list_get_icon_filename
                                            (GnomeIconList *gil,
                                             int idx);


gnome_icon_list_find_icon_from_filename ()

int         gnome_icon_list_find_icon_from_filename
                                            (GnomeIconList *gil,
                                             const char *filename);


gnome_icon_list_set_icon_data ()

void        gnome_icon_list_set_icon_data   (GnomeIconList *gil,
                                             int idx,
                                             gpointer data);


gnome_icon_list_set_icon_data_full ()

void        gnome_icon_list_set_icon_data_full
                                            (GnomeIconList *gil,
                                             int pos,
                                             gpointer data,
                                             GDestroyNotify destroy);

Associates the data pointer to the icon at the index specified by pos. The destroy argument points to a function that will be called when the icon is destroyed, or NULL if no function is to be called when this happens.


gnome_icon_list_find_icon_from_data ()

int         gnome_icon_list_find_icon_from_data
                                            (GnomeIconList *gil,
                                             gpointer data);


gnome_icon_list_get_icon_data ()

gpointer    gnome_icon_list_get_icon_data   (GnomeIconList *gil,
                                             int pos);


gnome_icon_list_moveto ()

void        gnome_icon_list_moveto          (GnomeIconList *gil,
                                             int pos,
                                             double yalign);

Makes the icon whose index is pos be visible on the screen. The icon list gets scrolled so that the icon is visible. An alignment of 0.0 represents the top of the visible part of the icon list, and 1.0 represents the bottom. An icon can be centered on the icon list.


gnome_icon_list_icon_is_visible ()

GtkVisibility gnome_icon_list_icon_is_visible
                                            (GnomeIconList *gil,
                                             int pos);


gnome_icon_list_get_icon_at ()

int         gnome_icon_list_get_icon_at     (GnomeIconList *gil,
                                             int x,
                                             int y);


gnome_icon_list_get_items_per_line ()

int         gnome_icon_list_get_items_per_line
                                            (GnomeIconList *gil);


gnome_icon_list_get_icon_text_item ()

GnomeIconTextItem* gnome_icon_list_get_icon_text_item
                                            (GnomeIconList *gil,
                                             int idx);


gnome_icon_list_get_icon_pixbuf_item ()

GnomeCanvasPixbuf* gnome_icon_list_get_icon_pixbuf_item
                                            (GnomeIconList *gil,
                                             int idx);

Signals

The "focus-icon" signal

void        user_function                  (GnomeIconList *iconlist,
                                            gint arg1,
                                            gpointer user_data);


The "move-cursor" signal

void        user_function                  (GnomeIconList *iconlist,
                                            GtkDirectionType arg1,
                                            gboolean arg2,
                                            gpointer user_data);


The "select-icon" signal

void        user_function                  (GnomeIconList *iconlist,
                                            gint arg1,
                                            GdkEvent *event,
                                            gpointer user_data);


The "text-changed" signal

gboolean    user_function                  (GnomeIconList *iconlist,
                                            gint arg1,
                                            gchar *arg2,
                                            gpointer user_data);


The "toggle-cursor-selection" signal

void        user_function                  (GnomeIconList *iconlist,
                                            gpointer user_data);


The "unselect-icon" signal

void        user_function                  (GnomeIconList *iconlist,
                                            gint arg1,
                                            GdkEvent *event,
                                            gpointer user_data);