Top | ![]() |
![]() |
![]() |
![]() |
GBoxed ╰── GtkIconListItem GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkFixed ╰── GtkIconList ╰── GtkFileList
GtkIconList is a GtkFixed subclass that allows you to display a table of xpm icons with editable labels. It's completely designed from scratch with some ideas borrowed from gnome-icon-list. It contains almost all of its features and more. It can be used for file browsers and as a replacement of gnome-icon-list (without the need of using gnome libraries). Like GtkSheet, it uses the widget GtkItemEntry to edit the text fields.
GtkWidget * gtk_icon_list_new (guint icon_width
,GtkIconListMode mode
);
Creates a new GtkIconList widget.
void gtk_icon_list_construct (GtkIconList *iconlist
,guint icon_width
,GtkIconListMode mode
);
Initialize iconlist structure.
iconlist |
GtkIconList widget created with |
|
icon_width |
the width of the icon |
|
mode |
GTK_ICON_LIST_ICON,GTK_ICON_LIST_TEXT_RIGHT,GTK_ICON_LIST_TEXT_BELOW |
void gtk_icon_list_set_mode (GtkIconList *iconlist
,GtkIconListMode mode
);
Set the icons display mode .
iconlist |
GtkIconList widget created with |
|
mode |
GTK_ICON_LIST_ICON,GTK_ICON_LIST_TEXT_RIGHT,GTK_ICON_LIST_TEXT_BELOW |
GtkIconListMode
gtk_icon_list_get_mode (GtkIconList *iconlist
);
Get the icons display mode .
void gtk_icon_list_set_editable (GtkIconList *iconlist
,gboolean editable
);
Set if the user can edit the text in the editable widget or not.
gboolean
gtk_icon_list_is_editable (GtkIconList *iconlist
);
Get the editable status of icon list.
void gtk_icon_list_set_row_spacing (GtkIconList *iconlist
,guint spacing
);
Set the icon spacing between rows.
iconlist |
GtkIconList widget created with |
|
spacing |
spacing between rows in pixels. |
guint
gtk_icon_list_get_row_spacing (GtkIconList *iconlist
);
Get the spacing between rows.
void gtk_icon_list_set_col_spacing (GtkIconList *iconlist
,guint spacing
);
Set the icon spacing between columns.
iconlist |
GtkIconList widget created with |
|
spacing |
spacing between columns in pixels. |
guint
gtk_icon_list_get_col_spacing (GtkIconList *iconlist
);
Get the spacing between columns.
void gtk_icon_list_set_text_space (GtkIconList *iconlist
,guint text_space
);
Set the text max size in pixels.
iconlist |
a GtkIconList widget created with |
|
text_space |
distance in pixels. |
guint
gtk_icon_list_get_text_space (GtkIconList *iconlist
);
Get the text maximum size in pixels.
void gtk_icon_list_set_icon_border (GtkIconList *iconlist
,guint border
);
Set the icon border.
iconlist |
a GtkIconList widget created with |
|
border |
icon border in pixels. |
guint
gtk_icon_list_get_icon_border (GtkIconList *iconlist
);
Get the icon border width.
void gtk_icon_list_set_icon_width (GtkIconList *iconlist
,guint width
);
Set the icon width.
iconlist |
a GtkIconList widget created with |
|
width |
icon width in pixels. |
guint
gtk_icon_list_get_icon_width (GtkIconList *iconlist
);
Get the icon width.
void gtk_icon_list_set_background (GtkIconList *iconlist
,GdkColor *color
);
Set the iconlist background color.
GtkIconListItem * gtk_icon_list_add_from_pixmap (GtkIconList *icon_list
,GdkPixmap *pixmap
,GdkBitmap *bitmap_mask
,const gchar *label
,gpointer link
);
Add a icon to the icon list.
icon_list |
a GtkIconList widget created with |
|
pixmap |
||
bitmap_mask |
||
label |
label of the icon |
|
link |
a gpointer link to some data |
GtkIconListItem * gtk_icon_list_add_from_data (GtkIconList *iconlist
,gchar **data
,const gchar *label
,gpointer link
);
Add a icon to the icon list.
iconlist |
a GtkIconList widget created with |
|
data |
pointer to the xpm data string |
|
label |
label of the icon |
|
link |
a data pointer |
GtkIconListItem * gtk_icon_list_add (GtkIconList *iconlist
,const gchar *pixmap_file
,const gchar *label
,gpointer link
);
Add a icon to the icon list.
iconlist |
GtkIconList widget created with |
|
pixmap_file |
from #include "file.xpm" |
|
label |
label of the icon |
|
link |
link |
GtkIconListItem * gtk_icon_list_get_nth (GtkIconList *iconlist
,guint n
);
Get nth icon from the icon list.
gint gtk_icon_list_get_index (GtkIconList *iconlist
,GtkIconListItem *item
);
Get the index number of the icon specified by its GtkIconListItem pointer.
void gtk_icon_list_remove (GtkIconList *iconlist
,GtkIconListItem *item
);
Remove the icon from the iconlist.
void gtk_icon_list_set_active_icon (GtkIconList *iconlist
,GtkIconListItem *icon
);
Set an active icon in the icon list.
void gtk_icon_list_remove_nth (GtkIconList *iconlist
,guint n
);
Remove nth icon from the iconlist.
void
gtk_icon_list_update (GtkIconList *iconlist
);
Update the icon list widget..
void
gtk_icon_list_clear (GtkIconList *iconlist
);
Clear the icon list widget.
void gtk_icon_list_link (GtkIconListItem *item
,gpointer data
);
Add a gpointer link to a icon from the iconlist.
gpointer
gtk_icon_list_get_link (GtkIconListItem *item
);
Add a gpointer link to a icon from the iconlist.
GtkIconListItem * gtk_icon_list_get_icon_from_link (GtkIconList *iconlist
,gpointer data
);
Gets the icon pointer from the link attached to it.
iconlist |
GtkIconList widget created with |
|
data |
a gpointer to some data |
GtkIconListItem * gtk_icon_list_get_icon_at (GtkIconList *iconlist
,gint x
,gint y
);
Get the icon situated at x,y coordinates in icon list.
iconlist |
GtkIconList widget created with |
|
x |
x coordindate |
|
y |
y coordinate |
GtkIconListItem *
gtk_icon_list_get_active_icon (GtkIconList *iconlist
);
Set the iconlist background color.
GtkWidget *
gtk_icon_list_get_entry (GtkIconListItem *item
);
Get the item->entry.
GtkWidget *
gtk_icon_list_get_pixmap (GtkIconListItem *item
);
Get the icon pixmap.
void gtk_icon_list_set_pixmap (GtkIconListItem *item
,GdkPixmap *pixmap
,GdkBitmap *bitmap_mask
);
Set the icon pixmap.
void gtk_icon_list_set_label (GtkIconList *iconlist
,GtkIconListItem *item
,const gchar *label
);
Set the icon label.
void gtk_icon_list_set_selection_mode (GtkIconList *iconlist
,gint mode
);
Set the icon selection mode.
iconlist |
GtkIconList widget created with |
|
mode |
GTK_ICON_LIST_ICON, GTK_ICON_LIST_TEXT_RIGHT, GTK_ICON_LIST_TEXT_BELOW |
void gtk_icon_list_select_icon (GtkIconList *iconlist
,GtkIconListItem *item
);
Select the icon specified by pointer.
void gtk_icon_list_unselect_icon (GtkIconList *iconlist
,GtkIconListItem *item
);
Unselect the icon specified by pointer.
void
gtk_icon_list_unselect_all (GtkIconList *iconlist
);
Unselect all icons.
struct GtkIconList;
The GtkIconList structure contains only private data. It should only be accessed through the functions described below.
“activate-icon”
signalgboolean user_function (GtkIconList *iconlist, GtkIconListItem *arg1, gpointer user_data)
iconlist |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“click-event”
signalvoid user_function (GtkIconList *iconlist, GdkEvent *arg1, gpointer user_data)
iconlist |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“deactivate-icon”
signalgboolean user_function (GtkIconList *iconlist, GtkIconListItem *arg1, gpointer user_data)
iconlist |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“select-icon”
signalgboolean user_function (GtkIconList *iconlist, GtkIconListItem *arg1, GdkEvent *arg2, gpointer user_data)
iconlist |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“text-changed”
signalgboolean user_function (GtkIconList *iconlist, GtkIconListItem *arg1, gchar *arg2, gpointer user_data)
iconlist |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“unselect-icon”
signalvoid user_function (GtkIconList *iconlist, GtkIconListItem *arg1, GdkEvent *arg2, gpointer user_data)
iconlist |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First