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
|
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/* fm-directory-view.h
*
* Copyright (C) 1999, 2000 Free Software Foundaton
* Copyright (C) 2000 Eazel, Inc.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* This program 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
* General Public License for more details.
*
* You should have received a copy of the GNU General Public
* License along with this program; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*
* Author: Ettore Perazzoli
*/
#ifndef FM_DIRECTORY_VIEW_H
#define FM_DIRECTORY_VIEW_H
#include <bonobo/bonobo-ui-handler.h>
#include <gtk/gtkmenu.h>
#include <gtk/gtkscrolledwindow.h>
#include <libnautilus/ntl-content-view-frame.h>
#include <libnautilus/nautilus-directory.h>
typedef struct _FMDirectoryView FMDirectoryView;
typedef struct _FMDirectoryViewClass FMDirectoryViewClass;
#define FM_TYPE_DIRECTORY_VIEW (fm_directory_view_get_type ())
#define FM_DIRECTORY_VIEW(obj) (GTK_CHECK_CAST ((obj), FM_TYPE_DIRECTORY_VIEW, FMDirectoryView))
#define FM_DIRECTORY_VIEW_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), FM_TYPE_DIRECTORY_VIEW, FMDirectoryViewClass))
#define FM_IS_DIRECTORY_VIEW(obj) (GTK_CHECK_TYPE ((obj), FM_TYPE_DIRECTORY_VIEW))
#define FM_IS_DIRECTORY_VIEW_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((obj), FM_TYPE_DIRECTORY_VIEW))
typedef struct _FMDirectoryViewDetails FMDirectoryViewDetails;
struct _FMDirectoryView {
GtkScrolledWindow parent;
FMDirectoryViewDetails *details;
};
struct _FMDirectoryViewClass {
GtkScrolledWindowClass parent_class;
/* The 'clear' signal is emitted to empty the view of its contents.
* It must be replaced by each subclass.
*/
void (* clear) (FMDirectoryView *view);
/* The 'begin_adding_entries' signal is emitted before a set of entries
* are added to the view. It can be replaced by a subclass to do any
* necessary preparation for a set of new entries. The default
* implementation does nothing.
*/
void (* begin_adding_entries) (FMDirectoryView *view);
/* The 'add_entry' signal is emitted to add one entry to the view.
* It must be replaced by each subclass.
*/
void (* add_entry) (FMDirectoryView *view,
NautilusFile *file);
/* The 'remove_entry' signal is emitted to remove one entry from the view.
* It must be replaced by each subclass.
*/
void (* remove_entry) (FMDirectoryView *view,
NautilusFile *file);
/* The 'done_adding_entries' signal is emitted after a set of entries
* are added to the view. It can be replaced by a subclass to do any
* necessary cleanup (typically, cleanup for code in begin_adding_entries).
* The default implementation does nothing.
*/
void (* done_adding_entries) (FMDirectoryView *view);
/* The 'begin_loading' signal is emitted before any of the contents
* of a directory are added to the view. It can be replaced by a
* subclass to do any necessary preparation to start dealing with a
* new directory. The default implementation does nothing.
*/
void (* begin_loading) (FMDirectoryView *view);
/* The 'append_selection_context_menu_items' signal is emitted
* when creating a context menu for the selected items. @files is
* the list of selected files; it isn't destroyed until the menu
* is destroyed so it can be used in callbacks.
* Subclasses might want to override this function to
* modify the menu contents.
*/
void (* append_selection_context_menu_items)
(FMDirectoryView *view,
GtkMenu *menu,
GList *files);
/* The 'append_background_context_menu_items' signal is emitted
* when creating a context menu, either an item-specific one or
* a background one. Subclasses might want to override this to
* modify the menu contents.
*/
void (* append_background_context_menu_items)
(FMDirectoryView *view,
GtkMenu *menu);
/* Function pointers that don't have corresponding signals */
/* get_selection is not a signal; it is just a function pointer for
* subclasses to replace (override). Subclasses must replace it
* with a function that returns a newly-allocated GList of
* NautilusFile pointers.
*/
GList * (* get_selection) (FMDirectoryView *view);
/* bump_zoom_level is a function pointer that subclasses must override
* to change the zoom level of an object. */
void (* bump_zoom_level) (FMDirectoryView *view,
int zoom_increment);
/* can_zoom_in is a function pointer that subclasses must override to
* return whether the view is at maximum size (furthest-in zoom level) */
gboolean (* can_zoom_in) (FMDirectoryView *view);
/* can_zoom_out is a function pointer that subclasses must override to
* return whether the view is at minimum size (furthest-out zoom level) */
gboolean (* can_zoom_out) (FMDirectoryView *view);
/* select_all is a function pointer that subclasses must override to
* select all of the items in the view */
void (* select_all) (FMDirectoryView *view);
/* merge_menus is a function pointer that subclasses can override to
* add their own menu items to the window's menu bar.
* If overridden, subclasses must call parent class's function.
*/
void (* merge_menus) (FMDirectoryView *view);
/* update_menus is a function pointer that subclasses can override to
* update the sensitivity or wording of menu items in the menu bar.
* It is called (at least) whenever the selection changes. If overridden,
* subclasses must call parent class's function.
*/
void (* update_menus) (FMDirectoryView *view);
};
/* GtkObject support */
GtkType fm_directory_view_get_type (void);
/* Component embedding support */
NautilusContentViewFrame *fm_directory_view_get_view_frame (FMDirectoryView *view);
/* URI handling */
void fm_directory_view_load_uri (FMDirectoryView *view,
const char *uri);
/* Functions callable from the user interface and elsewhere. */
GList * fm_directory_view_get_selection (FMDirectoryView *view);
void fm_directory_view_stop (FMDirectoryView *view);
gboolean fm_directory_view_can_zoom_in (FMDirectoryView *view);
gboolean fm_directory_view_can_zoom_out (FMDirectoryView *view);
void fm_directory_view_bump_zoom_level (FMDirectoryView *view,
int zoom_increment);
void fm_directory_view_select_all (FMDirectoryView *view);
/* Wrappers for signal emitters. These are normally called
* only by FMDirectoryView itself. They have corresponding signals
* that observers might want to connect with.
*/
void fm_directory_view_clear (FMDirectoryView *view);
void fm_directory_view_begin_loading (FMDirectoryView *view);
/* Hooks for subclasses to call. These are normally called only by
* FMDirectoryView and its subclasses
*/
void fm_directory_view_activate_entry (FMDirectoryView *view,
NautilusFile *file,
gboolean request_new_window);
void fm_directory_view_notify_selection_changed (FMDirectoryView *view);
BonoboUIHandler * fm_directory_view_get_bonobo_ui_handler (FMDirectoryView *view);
NautilusDirectory * fm_directory_view_get_model (FMDirectoryView *view);
void fm_directory_view_pop_up_background_context_menu (FMDirectoryView *view);
void fm_directory_view_pop_up_selection_context_menu (FMDirectoryView *view);
void fm_directory_view_update_menus (FMDirectoryView *view);
#endif /* FM_DIRECTORY_VIEW_H */
|
