X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkiconview.h;h=2adcc64c9887a0be1f0d6fefabf9945d93a7823c;hb=fa4878979e0a72890ca577a210ccd7cf6291dbf0;hp=229627359d065ab54ec75a2737c13f848126dfea;hpb=da6fe16842207a0bad216876ea81a7493c1138fd;p=~andy%2Fgtk diff --git a/gtk/gtkiconview.h b/gtk/gtkiconview.h index 229627359..2adcc64c9 100644 --- a/gtk/gtkiconview.h +++ b/gtk/gtkiconview.h @@ -1,4 +1,4 @@ -/* eggiconlist.h +/* gtkiconview.h * Copyright (C) 2002, 2004 Anders Carlsson * * This library is free software; you can redistribute it and/or @@ -12,103 +12,260 @@ * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public - * License along with this library; if not, write to the - * Free Software Foundation, Inc., 59 Temple Place - Suite 330, - * Boston, MA 02111-1307, USA. + * License along with this library. If not, see . */ -#ifndef __EGG_ICON_LIST_H__ -#define __EGG_ICON_LIST_H__ + +#ifndef __GTK_ICON_VIEW_H__ +#define __GTK_ICON_VIEW_H__ + +#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) +#error "Only can be included directly." +#endif #include #include +#include +#include +#include +#include G_BEGIN_DECLS -#define EGG_TYPE_ICON_LIST (egg_icon_list_get_type ()) -#define EGG_ICON_LIST(obj) (GTK_CHECK_CAST ((obj), EGG_TYPE_ICON_LIST, EggIconList)) -#define EGG_ICON_LIST_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), EGG_TYPE_ICON_LIST, EggIconListClass)) -#define EGG_IS_ICON_LIST(obj) (GTK_CHECK_TYPE ((obj), EGG_TYPE_ICON_LIST)) -#define EGG_IS_ICON_LIST_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), EGG_TYPE_ICON_LIST)) -#define EGG_ICON_LIST_GET_CLASS(obj) (GTK_CHECK_GET_CLASS ((obj), EGG_TYPE_ICON_LIST, EggIconListClass)) +#define GTK_TYPE_ICON_VIEW (gtk_icon_view_get_type ()) +#define GTK_ICON_VIEW(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_ICON_VIEW, GtkIconView)) +#define GTK_ICON_VIEW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_ICON_VIEW, GtkIconViewClass)) +#define GTK_IS_ICON_VIEW(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_ICON_VIEW)) +#define GTK_IS_ICON_VIEW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ICON_VIEW)) +#define GTK_ICON_VIEW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_ICON_VIEW, GtkIconViewClass)) -typedef struct _EggIconList EggIconList; -typedef struct _EggIconListClass EggIconListClass; -typedef struct _EggIconListPrivate EggIconListPrivate; -typedef struct _EggIconListItem EggIconListItem; +typedef struct _GtkIconView GtkIconView; +typedef struct _GtkIconViewClass GtkIconViewClass; +typedef struct _GtkIconViewPrivate GtkIconViewPrivate; -typedef void (* EggIconListForeachFunc) (EggIconList *icon_list, +/** + * GtkIconViewForeachFunc: + * @icon_view: a #GtkIconView + * @path: The #GtkTreePath of a selected row + * @data: user data + * + * A function used by gtk_icon_view_selected_foreach() to map all + * selected rows. It will be called on every selected row in the view. + */ +typedef void (* GtkIconViewForeachFunc) (GtkIconView *icon_view, GtkTreePath *path, gpointer data); -struct _EggIconList +/** + * GtkIconViewDropPosition: + * @GTK_ICON_VIEW_NO_DROP: no drop possible + * @GTK_ICON_VIEW_DROP_INTO: dropped item replaces the item + * @GTK_ICON_VIEW_DROP_LEFT: droppped item is inserted to the left + * @GTK_ICON_VIEW_DROP_RIGHT: dropped item is inserted to the right + * @GTK_ICON_VIEW_DROP_ABOVE: dropped item is inserted above + * @GTK_ICON_VIEW_DROP_BELOW: dropped item is inserted below + * + * An enum for determining where a dropped item goes. + */ +typedef enum +{ + GTK_ICON_VIEW_NO_DROP, + GTK_ICON_VIEW_DROP_INTO, + GTK_ICON_VIEW_DROP_LEFT, + GTK_ICON_VIEW_DROP_RIGHT, + GTK_ICON_VIEW_DROP_ABOVE, + GTK_ICON_VIEW_DROP_BELOW +} GtkIconViewDropPosition; + +struct _GtkIconView { GtkContainer parent; - EggIconListPrivate *priv; + /*< private >*/ + GtkIconViewPrivate *priv; }; -struct _EggIconListClass +struct _GtkIconViewClass { GtkContainerClass parent_class; - void (* set_scroll_adjustments) (EggIconList *icon_list, - GtkAdjustment *hadjustment, - GtkAdjustment *vadjustment); - - void (* item_activated) (EggIconList *icon_list, + void (* item_activated) (GtkIconView *icon_view, GtkTreePath *path); - void (* selection_changed) (EggIconList *icon_list); + void (* selection_changed) (GtkIconView *icon_view); /* Key binding signals */ - void (* select_all) (EggIconList *icon_list); - void (* unselect_all) (EggIconList *icon_list); - void (* select_cursor_item) (EggIconList *icon_list); - void (* toggle_cursor_item) (EggIconList *icon_list); - gboolean (* move_cursor) (EggIconList *icon_list, + void (* select_all) (GtkIconView *icon_view); + void (* unselect_all) (GtkIconView *icon_view); + void (* select_cursor_item) (GtkIconView *icon_view); + void (* toggle_cursor_item) (GtkIconView *icon_view); + gboolean (* move_cursor) (GtkIconView *icon_view, GtkMovementStep step, gint count); + gboolean (* activate_cursor_item) (GtkIconView *icon_view); + + /* Padding for future expansion */ + void (*_gtk_reserved1) (void); + void (*_gtk_reserved2) (void); + void (*_gtk_reserved3) (void); + void (*_gtk_reserved4) (void); }; -GType egg_icon_list_get_type (void); -GtkWidget *egg_icon_list_new (void); -GtkWidget *egg_icon_list_new_with_model (GtkTreeModel *model); - -void egg_icon_list_set_model (EggIconList *icon_list, - GtkTreeModel *model); -GtkTreeModel *egg_icon_list_get_model (EggIconList *icon_list); -void egg_icon_list_set_text_column (EggIconList *icon_list, - gint column); -gint egg_icon_list_get_text_column (EggIconList *icon_list); -void egg_icon_list_set_markup_column (EggIconList *icon_list, - int column); -gint egg_icon_list_get_markup_column (EggIconList *icon_list); -void egg_icon_list_set_pixbuf_column (EggIconList *icon_list, - gint column); -gint egg_icon_list_get_pixbuf_column (EggIconList *icon_list); - - -GtkTreePath * egg_icon_list_get_path_at_pos (EggIconList *icon_list, - gint x, - gint y); -void egg_icon_list_selected_foreach (EggIconList *icon_list, - EggIconListForeachFunc func, - gpointer data); -void egg_icon_list_set_selection_mode (EggIconList *icon_list, - GtkSelectionMode mode); -GtkSelectionMode egg_icon_list_get_selection_mode (EggIconList *icon_list); -void egg_icon_list_select_path (EggIconList *icon_list, +GType gtk_icon_view_get_type (void) G_GNUC_CONST; +GtkWidget * gtk_icon_view_new (void); +GtkWidget * gtk_icon_view_new_with_area (GtkCellArea *area); +GtkWidget * gtk_icon_view_new_with_model (GtkTreeModel *model); + +void gtk_icon_view_set_model (GtkIconView *icon_view, + GtkTreeModel *model); +GtkTreeModel * gtk_icon_view_get_model (GtkIconView *icon_view); +void gtk_icon_view_set_text_column (GtkIconView *icon_view, + gint column); +gint gtk_icon_view_get_text_column (GtkIconView *icon_view); +void gtk_icon_view_set_markup_column (GtkIconView *icon_view, + gint column); +gint gtk_icon_view_get_markup_column (GtkIconView *icon_view); +void gtk_icon_view_set_pixbuf_column (GtkIconView *icon_view, + gint column); +gint gtk_icon_view_get_pixbuf_column (GtkIconView *icon_view); + +void gtk_icon_view_set_item_orientation (GtkIconView *icon_view, + GtkOrientation orientation); +GtkOrientation gtk_icon_view_get_item_orientation (GtkIconView *icon_view); +void gtk_icon_view_set_columns (GtkIconView *icon_view, + gint columns); +gint gtk_icon_view_get_columns (GtkIconView *icon_view); +void gtk_icon_view_set_item_width (GtkIconView *icon_view, + gint item_width); +gint gtk_icon_view_get_item_width (GtkIconView *icon_view); +void gtk_icon_view_set_spacing (GtkIconView *icon_view, + gint spacing); +gint gtk_icon_view_get_spacing (GtkIconView *icon_view); +void gtk_icon_view_set_row_spacing (GtkIconView *icon_view, + gint row_spacing); +gint gtk_icon_view_get_row_spacing (GtkIconView *icon_view); +void gtk_icon_view_set_column_spacing (GtkIconView *icon_view, + gint column_spacing); +gint gtk_icon_view_get_column_spacing (GtkIconView *icon_view); +void gtk_icon_view_set_margin (GtkIconView *icon_view, + gint margin); +gint gtk_icon_view_get_margin (GtkIconView *icon_view); +void gtk_icon_view_set_item_padding (GtkIconView *icon_view, + gint item_padding); +gint gtk_icon_view_get_item_padding (GtkIconView *icon_view); + +GtkTreePath * gtk_icon_view_get_path_at_pos (GtkIconView *icon_view, + gint x, + gint y); +gboolean gtk_icon_view_get_item_at_pos (GtkIconView *icon_view, + gint x, + gint y, + GtkTreePath **path, + GtkCellRenderer **cell); +gboolean gtk_icon_view_get_visible_range (GtkIconView *icon_view, + GtkTreePath **start_path, + GtkTreePath **end_path); +GDK_AVAILABLE_IN_3_8 +void gtk_icon_view_set_activate_on_single_click (GtkIconView *icon_view, + gboolean single); +GDK_AVAILABLE_IN_3_8 +gboolean gtk_icon_view_get_activate_on_single_click (GtkIconView *icon_view); + +void gtk_icon_view_selected_foreach (GtkIconView *icon_view, + GtkIconViewForeachFunc func, + gpointer data); +void gtk_icon_view_set_selection_mode (GtkIconView *icon_view, + GtkSelectionMode mode); +GtkSelectionMode gtk_icon_view_get_selection_mode (GtkIconView *icon_view); +void gtk_icon_view_select_path (GtkIconView *icon_view, GtkTreePath *path); -void egg_icon_list_unselect_path (EggIconList *icon_list, +void gtk_icon_view_unselect_path (GtkIconView *icon_view, GtkTreePath *path); -gboolean egg_icon_list_path_is_selected (EggIconList *icon_list, +gboolean gtk_icon_view_path_is_selected (GtkIconView *icon_view, GtkTreePath *path); -void egg_icon_list_select_all (EggIconList *icon_list); -void egg_icon_list_unselect_all (EggIconList *icon_list); -void egg_icon_list_item_activated (EggIconList *icon_list, +gint gtk_icon_view_get_item_row (GtkIconView *icon_view, + GtkTreePath *path); +gint gtk_icon_view_get_item_column (GtkIconView *icon_view, + GtkTreePath *path); +GList *gtk_icon_view_get_selected_items (GtkIconView *icon_view); +void gtk_icon_view_select_all (GtkIconView *icon_view); +void gtk_icon_view_unselect_all (GtkIconView *icon_view); +void gtk_icon_view_item_activated (GtkIconView *icon_view, GtkTreePath *path); +void gtk_icon_view_set_cursor (GtkIconView *icon_view, + GtkTreePath *path, + GtkCellRenderer *cell, + gboolean start_editing); +gboolean gtk_icon_view_get_cursor (GtkIconView *icon_view, + GtkTreePath **path, + GtkCellRenderer **cell); +void gtk_icon_view_scroll_to_path (GtkIconView *icon_view, + GtkTreePath *path, + gboolean use_align, + gfloat row_align, + gfloat col_align); + +/* Drag-and-Drop support */ +void gtk_icon_view_enable_model_drag_source (GtkIconView *icon_view, + GdkModifierType start_button_mask, + const GtkTargetEntry *targets, + gint n_targets, + GdkDragAction actions); +void gtk_icon_view_enable_model_drag_dest (GtkIconView *icon_view, + const GtkTargetEntry *targets, + gint n_targets, + GdkDragAction actions); +void gtk_icon_view_unset_model_drag_source (GtkIconView *icon_view); +void gtk_icon_view_unset_model_drag_dest (GtkIconView *icon_view); +void gtk_icon_view_set_reorderable (GtkIconView *icon_view, + gboolean reorderable); +gboolean gtk_icon_view_get_reorderable (GtkIconView *icon_view); + + +/* These are useful to implement your own custom stuff. */ +void gtk_icon_view_set_drag_dest_item (GtkIconView *icon_view, + GtkTreePath *path, + GtkIconViewDropPosition pos); +void gtk_icon_view_get_drag_dest_item (GtkIconView *icon_view, + GtkTreePath **path, + GtkIconViewDropPosition *pos); +gboolean gtk_icon_view_get_dest_item_at_pos (GtkIconView *icon_view, + gint drag_x, + gint drag_y, + GtkTreePath **path, + GtkIconViewDropPosition *pos); +cairo_surface_t *gtk_icon_view_create_drag_icon (GtkIconView *icon_view, + GtkTreePath *path); + +void gtk_icon_view_convert_widget_to_bin_window_coords (GtkIconView *icon_view, + gint wx, + gint wy, + gint *bx, + gint *by); +GDK_AVAILABLE_IN_3_6 +gboolean gtk_icon_view_get_cell_rect (GtkIconView *icon_view, + GtkTreePath *path, + GtkCellRenderer *cell, + GdkRectangle *rect); + +void gtk_icon_view_set_tooltip_item (GtkIconView *icon_view, + GtkTooltip *tooltip, + GtkTreePath *path); +void gtk_icon_view_set_tooltip_cell (GtkIconView *icon_view, + GtkTooltip *tooltip, + GtkTreePath *path, + GtkCellRenderer *cell); +gboolean gtk_icon_view_get_tooltip_context (GtkIconView *icon_view, + gint *x, + gint *y, + gboolean keyboard_tip, + GtkTreeModel **model, + GtkTreePath **path, + GtkTreeIter *iter); +void gtk_icon_view_set_tooltip_column (GtkIconView *icon_view, + gint column); +gint gtk_icon_view_get_tooltip_column (GtkIconView *icon_view); G_END_DECLS -#endif /* __EGG_ICON_LIST_H__ */ +#endif /* __GTK_ICON_VIEW_H__ */