/usr/include/exo-2/exo/exo-icon-view.h is in libexo-2-dev 0.12.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 | /*-
* Copyright (c) 2004-2006 os-cillation e.K.
* Copyright (c) 2002,2004 Anders Carlsson <andersca@gnu.org>
*
* Written by Benedikt Meurer <benny@xfce.org>.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA 02110-1301 USA
*/
#if !defined (EXO_INSIDE_EXO_H) && !defined (EXO_COMPILATION)
#error "Only <exo/exo.h> can be included directly, this file may disappear or change contents."
#endif
#ifndef __EXO_ICON_VIEW_H__
#define __EXO_ICON_VIEW_H__
#include <gtk/gtk.h>
G_BEGIN_DECLS
typedef struct _ExoIconViewPrivate ExoIconViewPrivate;
typedef struct _ExoIconViewClass ExoIconViewClass;
typedef struct _ExoIconView ExoIconView;
#define EXO_TYPE_ICON_VIEW (exo_icon_view_get_type ())
#define EXO_ICON_VIEW(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), EXO_TYPE_ICON_VIEW, ExoIconView))
#define EXO_ICON_VIEW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), EXO_TYPE_ICON_VIEW, ExoIconViewClass))
#define EXO_IS_ICON_VIEW(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), EXO_TYPE_ICON_VIEW))
#define EXO_IS_ICON_VIEW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), EXO_TYPE_ICON_VIEW))
#define EXO_ICON_VIEW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), EXO_TYPE_ICON_VIEW, ExoIconViewClass))
/**
* ExoIconViewForeachFunc:
* @icon_view : an #ExoIconView.
* @path : the current path.
* @user_data : the user data supplied to exo_icon_view_selected_foreach().
*
* Callback function prototype, invoked for every selected path in the
* @icon_view. See exo_icon_view_selected_foreach() for details.
**/
typedef void (*ExoIconViewForeachFunc) (ExoIconView *icon_view,
GtkTreePath *path,
gpointer user_data);
/**
* ExoIconViewSearchEqualFunc:
* @model : the #GtkTreeModel being searched.
* @column : the search column set by exo_icon_view_set_search_column().
* @key : the key string to compare with.
* @iter : the #GtkTreeIter of the current item.
* @search_data : user data from exo_icon_view_set_search_equal_func().
*
* A function used for checking whether a row in @model matches a search key string
* entered by the user. Note the return value is reversed from what you would normally
* expect, though it has some similarity to strcmp() returning 0 for equal strings.
*
* Returns: %FALSE if the row matches, %TRUE otherwise.
**/
typedef gboolean (*ExoIconViewSearchEqualFunc) (GtkTreeModel *model,
gint column,
const gchar *key,
GtkTreeIter *iter,
gpointer search_data);
/**
* ExoIconViewSearchPositionFunc:
* @icon_view : an #ExoIconView.
* @search_dialog : the search dialog window to place.
* @user_data : user data from exo_icon_view_set_search_position_func().
*
* A function used to place the @search_dialog for the @icon_view.
**/
typedef void (*ExoIconViewSearchPositionFunc) (ExoIconView *icon_view,
GtkWidget *search_dialog,
gpointer user_data);
/**
* ExoIconViewDropPosition:
* @EXO_ICON_VIEW_NO_DROP : no drop indicator.
* @EXO_ICON_VIEW_DROP_INTO : drop indicator on an item.
* @EXO_ICON_VIEW_DROP_LEFT : drop indicator on the left of an item.
* @EXO_ICON_VIEW_DROP_RIGHT : drop indicator on the right of an item.
* @EXO_ICON_VIEW_DROP_ABOVE : drop indicator above an item.
* @EXO_ICON_VIEW_DROP_BELOW : drop indicator below an item.
*
* Specifies whether to display the drop indicator,
* i.e. where to drop into the icon view.
**/
typedef enum
{
EXO_ICON_VIEW_NO_DROP,
EXO_ICON_VIEW_DROP_INTO,
EXO_ICON_VIEW_DROP_LEFT,
EXO_ICON_VIEW_DROP_RIGHT,
EXO_ICON_VIEW_DROP_ABOVE,
EXO_ICON_VIEW_DROP_BELOW
} ExoIconViewDropPosition;
/**
* ExoIconViewLayoutMode:
* @EXO_ICON_VIEW_LAYOUT_ROWS : layout items in rows.
* @EXO_ICON_VIEW_LAYOUT_COLS : layout items in columns.
*
* Specifies the layouting mode of an #ExoIconView. @EXO_ICON_VIEW_LAYOUT_ROWS
* is the default, which lays out items vertically in rows from top to bottom.
* @EXO_ICON_VIEW_LAYOUT_COLS lays out items horizontally in columns from left
* to right.
**/
typedef enum
{
EXO_ICON_VIEW_LAYOUT_ROWS,
EXO_ICON_VIEW_LAYOUT_COLS
} ExoIconViewLayoutMode;
/**
* ExoIconView:
*
* #ExoIconView provides an alternative view on a list model.
* It displays the model as a grid of icons with labels. Like
* #GtkTreeView, it allows to select one or multiple items
* (depending on the selection mode, see exo_icon_view_set_selection_mode()).
* In addition to selection with the arrow keys, #ExoIconView supports
* rubberband selection, which is controlled by dragging the pointer.
**/
struct _ExoIconView
{
GtkContainer __parent__;
/*< private >*/
ExoIconViewPrivate *priv;
};
struct _ExoIconViewClass
{
GtkContainerClass __parent__;
/* virtual methods */
void (*set_scroll_adjustments) (ExoIconView *icon_view,
GtkAdjustment *hadjustment,
GtkAdjustment *vadjustment);
/* signals */
void (*item_activated) (ExoIconView *icon_view,
GtkTreePath *path);
void (*selection_changed) (ExoIconView *icon_view);
/* Key binding signals */
void (*select_all) (ExoIconView *icon_view);
void (*unselect_all) (ExoIconView *icon_view);
void (*select_cursor_item) (ExoIconView *icon_view);
void (*toggle_cursor_item) (ExoIconView *icon_view);
gboolean (*move_cursor) (ExoIconView *icon_view,
GtkMovementStep step,
gint count);
gboolean (*activate_cursor_item) (ExoIconView *icon_view);
gboolean (*start_interactive_search) (ExoIconView *icon_view);
/*< private >*/
void (*reserved0) (void);
void (*reserved1) (void);
void (*reserved2) (void);
void (*reserved3) (void);
void (*reserved4) (void);
void (*reserved5) (void);
void (*reserved6) (void);
void (*reserved7) (void);
void (*reserved8) (void);
void (*reserved9) (void);
};
GType exo_icon_view_get_type (void) G_GNUC_CONST;
GtkWidget *exo_icon_view_new (void);
GtkWidget *exo_icon_view_new_with_model (GtkTreeModel *model);
GtkTreeModel *exo_icon_view_get_model (const ExoIconView *icon_view);
void exo_icon_view_set_model (ExoIconView *icon_view,
GtkTreeModel *model);
GtkOrientation exo_icon_view_get_orientation (const ExoIconView *icon_view);
void exo_icon_view_set_orientation (ExoIconView *icon_view,
GtkOrientation orientation);
gint exo_icon_view_get_columns (const ExoIconView *icon_view);
void exo_icon_view_set_columns (ExoIconView *icon_view,
gint columns);
gint exo_icon_view_get_item_width (const ExoIconView *icon_view);
void exo_icon_view_set_item_width (ExoIconView *icon_view,
gint item_width);
gint exo_icon_view_get_spacing (const ExoIconView *icon_view);
void exo_icon_view_set_spacing (ExoIconView *icon_view,
gint spacing);
gint exo_icon_view_get_row_spacing (const ExoIconView *icon_view);
void exo_icon_view_set_row_spacing (ExoIconView *icon_view,
gint row_spacing);
gint exo_icon_view_get_column_spacing (const ExoIconView *icon_view);
void exo_icon_view_set_column_spacing (ExoIconView *icon_view,
gint column_spacing);
gint exo_icon_view_get_margin (const ExoIconView *icon_view);
void exo_icon_view_set_margin (ExoIconView *icon_view,
gint margin);
GtkSelectionMode exo_icon_view_get_selection_mode (const ExoIconView *icon_view);
void exo_icon_view_set_selection_mode (ExoIconView *icon_view,
GtkSelectionMode mode);
ExoIconViewLayoutMode exo_icon_view_get_layout_mode (const ExoIconView *icon_view);
void exo_icon_view_set_layout_mode (ExoIconView *icon_view,
ExoIconViewLayoutMode layout_mode);
gboolean exo_icon_view_get_single_click (const ExoIconView *icon_view);
void exo_icon_view_set_single_click (ExoIconView *icon_view,
gboolean single_click);
guint exo_icon_view_get_single_click_timeout (const ExoIconView *icon_view);
void exo_icon_view_set_single_click_timeout (ExoIconView *icon_view,
guint single_click_timeout);
void exo_icon_view_widget_to_icon_coords (const ExoIconView *icon_view,
gint wx,
gint wy,
gint *ix,
gint *iy);
void exo_icon_view_icon_to_widget_coords (const ExoIconView *icon_view,
gint ix,
gint iy,
gint *wx,
gint *wy);
GtkTreePath *exo_icon_view_get_path_at_pos (const ExoIconView *icon_view,
gint x,
gint y);
gboolean exo_icon_view_get_item_at_pos (const ExoIconView *icon_view,
gint x,
gint y,
GtkTreePath **path,
GtkCellRenderer **cell);
gboolean exo_icon_view_get_visible_range (const ExoIconView *icon_view,
GtkTreePath **start_path,
GtkTreePath **end_path);
void exo_icon_view_selected_foreach (ExoIconView *icon_view,
ExoIconViewForeachFunc func,
gpointer data);
void exo_icon_view_select_path (ExoIconView *icon_view,
GtkTreePath *path);
void exo_icon_view_unselect_path (ExoIconView *icon_view,
GtkTreePath *path);
gboolean exo_icon_view_path_is_selected (const ExoIconView *icon_view,
GtkTreePath *path);
GList *exo_icon_view_get_selected_items (const ExoIconView *icon_view);
void exo_icon_view_select_all (ExoIconView *icon_view);
void exo_icon_view_unselect_all (ExoIconView *icon_view);
void exo_icon_view_selection_invert (ExoIconView *icon_view);
void exo_icon_view_item_activated (ExoIconView *icon_view,
GtkTreePath *path);
gint exo_icon_view_get_item_column (ExoIconView *icon_view,
GtkTreePath *path);
gint exo_icon_view_get_item_row (ExoIconView *icon_view,
GtkTreePath *path);
gboolean exo_icon_view_get_cursor (const ExoIconView *icon_view,
GtkTreePath **path,
GtkCellRenderer **cell);
void exo_icon_view_set_cursor (ExoIconView *icon_view,
GtkTreePath *path,
GtkCellRenderer *cell,
gboolean start_editing);
void exo_icon_view_scroll_to_path (ExoIconView *icon_view,
GtkTreePath *path,
gboolean use_align,
gfloat row_align,
gfloat col_align);
/* Drag-and-Drop support */
void exo_icon_view_enable_model_drag_source (ExoIconView *icon_view,
GdkModifierType start_button_mask,
const GtkTargetEntry *targets,
gint n_targets,
GdkDragAction actions);
void exo_icon_view_enable_model_drag_dest (ExoIconView *icon_view,
const GtkTargetEntry *targets,
gint n_targets,
GdkDragAction actions);
void exo_icon_view_unset_model_drag_source (ExoIconView *icon_view);
void exo_icon_view_unset_model_drag_dest (ExoIconView *icon_view);
void exo_icon_view_set_reorderable (ExoIconView *icon_view,
gboolean reorderable);
gboolean exo_icon_view_get_reorderable (ExoIconView *icon_view);
/* These are useful to implement your own custom stuff. */
void exo_icon_view_set_drag_dest_item (ExoIconView *icon_view,
GtkTreePath *path,
ExoIconViewDropPosition pos);
void exo_icon_view_get_drag_dest_item (ExoIconView *icon_view,
GtkTreePath **path,
ExoIconViewDropPosition *pos);
gboolean exo_icon_view_get_dest_item_at_pos (ExoIconView *icon_view,
gint drag_x,
gint drag_y,
GtkTreePath **path,
ExoIconViewDropPosition *pos);
#if GTK_CHECK_VERSION (3, 0, 0)
cairo_surface_t *exo_icon_view_create_drag_icon (ExoIconView *icon_view,
GtkTreePath *path);
#else
GdkPixmap *exo_icon_view_create_drag_icon (ExoIconView *icon_view,
GtkTreePath *path);
#endif
/* Interactive search support */
gboolean exo_icon_view_get_enable_search (const ExoIconView *icon_view);
void exo_icon_view_set_enable_search (ExoIconView *icon_view,
gboolean enable_search);
gint exo_icon_view_get_search_column (const ExoIconView *icon_view);
void exo_icon_view_set_search_column (ExoIconView *icon_view,
gint search_column);
ExoIconViewSearchEqualFunc exo_icon_view_get_search_equal_func (const ExoIconView *icon_view);
void exo_icon_view_set_search_equal_func (ExoIconView *icon_view,
ExoIconViewSearchEqualFunc search_equal_func,
gpointer search_equal_data,
GDestroyNotify search_equal_destroy);
ExoIconViewSearchPositionFunc exo_icon_view_get_search_position_func (const ExoIconView *icon_view);
void exo_icon_view_set_search_position_func (ExoIconView *icon_view,
ExoIconViewSearchPositionFunc search_position_func,
gpointer search_position_data,
GDestroyNotify search_position_destroy);
G_END_DECLS
#endif /* __EXO_ICON_VIEW_H__ */
|