2011-09-06 22:53:30 +00:00
|
|
|
|
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
|
|
|
|
|
|
2015-11-19 12:44:17 +00:00
|
|
|
|
/* GtkPlacesSidebar - sidebar widget for places in the filesystem
|
2011-09-06 22:53:30 +00:00
|
|
|
|
*
|
2015-11-19 12:44:17 +00:00
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
|
* it under the terms of the GNU Lesser General Public License as published
|
|
|
|
|
* by the Free Software Foundation, either version 2.1 of the License, or
|
|
|
|
|
* (at your option) any later version.
|
2011-09-06 22:53:30 +00:00
|
|
|
|
*
|
2015-11-19 12:44:17 +00:00
|
|
|
|
* 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 Lesser General Public License for more details.
|
2011-09-06 22:53:30 +00:00
|
|
|
|
*
|
2015-11-19 12:44:17 +00:00
|
|
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
2011-09-06 22:53:30 +00:00
|
|
|
|
*
|
2015-11-19 12:44:17 +00:00
|
|
|
|
* This code comes from Nautilus, GNOME’s file manager.
|
2011-09-06 22:53:30 +00:00
|
|
|
|
*
|
2015-11-19 12:44:17 +00:00
|
|
|
|
* Authors : Mr Jamie McCracken (jamiemcc at blueyonder dot co dot uk)
|
|
|
|
|
* Federico Mena Quintero <federico@gnome.org>
|
2011-09-06 22:53:30 +00:00
|
|
|
|
*/
|
|
|
|
|
|
2011-09-06 23:11:19 +00:00
|
|
|
|
#ifndef __GTK_PLACES_SIDEBAR_H__
|
|
|
|
|
#define __GTK_PLACES_SIDEBAR_H__
|
2011-09-06 22:53:30 +00:00
|
|
|
|
|
2014-12-09 00:31:56 +00:00
|
|
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
|
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
|
|
|
#endif
|
|
|
|
|
|
2011-09-06 23:11:19 +00:00
|
|
|
|
#include <gtk/gtkwidget.h>
|
2011-09-06 22:53:30 +00:00
|
|
|
|
|
2012-09-04 02:29:48 +00:00
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
2011-09-06 23:11:19 +00:00
|
|
|
|
#define GTK_TYPE_PLACES_SIDEBAR (gtk_places_sidebar_get_type ())
|
|
|
|
|
#define GTK_PLACES_SIDEBAR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_PLACES_SIDEBAR, GtkPlacesSidebar))
|
|
|
|
|
#define GTK_PLACES_SIDEBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_PLACES_SIDEBAR, GtkPlacesSidebarClass))
|
|
|
|
|
#define GTK_IS_PLACES_SIDEBAR(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_PLACES_SIDEBAR))
|
|
|
|
|
#define GTK_IS_PLACES_SIDEBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_PLACES_SIDEBAR))
|
|
|
|
|
#define GTK_PLACES_SIDEBAR_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_PLACES_SIDEBAR, GtkPlacesSidebarClass))
|
2011-09-06 22:53:30 +00:00
|
|
|
|
|
2011-09-07 19:58:19 +00:00
|
|
|
|
typedef struct _GtkPlacesSidebar GtkPlacesSidebar;
|
|
|
|
|
typedef struct _GtkPlacesSidebarClass GtkPlacesSidebarClass;
|
|
|
|
|
|
2013-01-19 01:28:58 +00:00
|
|
|
|
/**
|
|
|
|
|
* GtkPlacesOpenFlags:
|
|
|
|
|
* @GTK_PLACES_OPEN_NORMAL: This is the default mode that #GtkPlacesSidebar uses if no other flags
|
|
|
|
|
* are specified. It indicates that the calling application should open the selected location
|
|
|
|
|
* in the normal way, for example, in the folder view beside the sidebar.
|
|
|
|
|
* @GTK_PLACES_OPEN_NEW_TAB: When passed to gtk_places_sidebar_set_open_flags(), this indicates
|
|
|
|
|
* that the application can open folders selected from the sidebar in new tabs. This value
|
|
|
|
|
* will be passed to the #GtkPlacesSidebar::open-location signal when the user selects
|
|
|
|
|
* that a location be opened in a new tab instead of in the standard fashion.
|
|
|
|
|
* @GTK_PLACES_OPEN_NEW_WINDOW: Similar to @GTK_PLACES_OPEN_NEW_TAB, but indicates that the application
|
|
|
|
|
* can open folders in new windows.
|
|
|
|
|
*
|
|
|
|
|
* These flags serve two purposes. First, the application can call gtk_places_sidebar_set_open_flags()
|
|
|
|
|
* using these flags as a bitmask. This tells the sidebar that the application is able to open
|
|
|
|
|
* folders selected from the sidebar in various ways, for example, in new tabs or in new windows in
|
|
|
|
|
* addition to the normal mode.
|
|
|
|
|
*
|
|
|
|
|
* Second, when one of these values gets passed back to the application in the
|
|
|
|
|
* #GtkPlacesSidebar::open-location signal, it means that the application should
|
|
|
|
|
* open the selected location in the normal way, in a new tab, or in a new
|
|
|
|
|
* window. The sidebar takes care of determining the desired way to open the location,
|
|
|
|
|
* based on the modifier keys that the user is pressing at the time the selection is made.
|
|
|
|
|
*
|
|
|
|
|
* If the application never calls gtk_places_sidebar_set_open_flags(), then the sidebar will only
|
|
|
|
|
* use #GTK_PLACES_OPEN_NORMAL in the #GtkPlacesSidebar::open-location signal. This is the
|
|
|
|
|
* default mode of operation.
|
|
|
|
|
*/
|
2011-09-28 15:22:05 +00:00
|
|
|
|
typedef enum {
|
2013-01-10 22:19:03 +00:00
|
|
|
|
GTK_PLACES_OPEN_NORMAL = 1 << 0,
|
|
|
|
|
GTK_PLACES_OPEN_NEW_TAB = 1 << 1,
|
|
|
|
|
GTK_PLACES_OPEN_NEW_WINDOW = 1 << 2
|
|
|
|
|
} GtkPlacesOpenFlags;
|
2011-09-28 15:22:05 +00:00
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
GType gtk_places_sidebar_get_type (void) G_GNUC_CONST;
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
GtkWidget * gtk_places_sidebar_new (void);
|
2011-09-06 22:53:30 +00:00
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
GtkPlacesOpenFlags gtk_places_sidebar_get_open_flags (GtkPlacesSidebar *sidebar);
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
void gtk_places_sidebar_set_open_flags (GtkPlacesSidebar *sidebar,
|
|
|
|
|
GtkPlacesOpenFlags flags);
|
2013-01-10 22:19:03 +00:00
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
GFile * gtk_places_sidebar_get_location (GtkPlacesSidebar *sidebar);
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
void gtk_places_sidebar_set_location (GtkPlacesSidebar *sidebar,
|
|
|
|
|
GFile *location);
|
2012-12-18 02:05:23 +00:00
|
|
|
|
|
2015-06-06 21:13:22 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
gboolean gtk_places_sidebar_get_show_recent (GtkPlacesSidebar *sidebar);
|
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
void gtk_places_sidebar_set_show_recent (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_recent);
|
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
gboolean gtk_places_sidebar_get_show_desktop (GtkPlacesSidebar *sidebar);
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
void gtk_places_sidebar_set_show_desktop (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_desktop);
|
2011-10-04 14:47:41 +00:00
|
|
|
|
|
2015-07-14 17:47:42 +00:00
|
|
|
|
GDK_DEPRECATED_IN_3_18
|
2013-05-02 01:23:55 +00:00
|
|
|
|
gboolean gtk_places_sidebar_get_show_connect_to_server (GtkPlacesSidebar *sidebar);
|
2015-07-14 17:47:42 +00:00
|
|
|
|
GDK_DEPRECATED_IN_3_18
|
2013-05-02 01:23:55 +00:00
|
|
|
|
void gtk_places_sidebar_set_show_connect_to_server (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_connect_to_server);
|
2014-04-07 22:43:28 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_14
|
|
|
|
|
gboolean gtk_places_sidebar_get_show_enter_location (GtkPlacesSidebar *sidebar);
|
|
|
|
|
GDK_AVAILABLE_IN_3_14
|
|
|
|
|
void gtk_places_sidebar_set_show_enter_location (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_enter_location);
|
2013-04-20 23:14:59 +00:00
|
|
|
|
|
2013-11-09 23:28:12 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_12
|
|
|
|
|
void gtk_places_sidebar_set_local_only (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean local_only);
|
|
|
|
|
GDK_AVAILABLE_IN_3_12
|
|
|
|
|
gboolean gtk_places_sidebar_get_local_only (GtkPlacesSidebar *sidebar);
|
|
|
|
|
|
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
void gtk_places_sidebar_add_shortcut (GtkPlacesSidebar *sidebar,
|
|
|
|
|
GFile *location);
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
void gtk_places_sidebar_remove_shortcut (GtkPlacesSidebar *sidebar,
|
|
|
|
|
GFile *location);
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
GSList * gtk_places_sidebar_list_shortcuts (GtkPlacesSidebar *sidebar);
|
2012-12-07 19:42:39 +00:00
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
2013-05-02 01:23:55 +00:00
|
|
|
|
GFile * gtk_places_sidebar_get_nth_bookmark (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gint n);
|
2015-04-11 15:35:23 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
void gtk_places_sidebar_set_drop_targets_visible (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean visible,
|
|
|
|
|
GdkDragContext *context);
|
2015-07-03 16:49:00 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
gboolean gtk_places_sidebar_get_show_trash (GtkPlacesSidebar *sidebar);
|
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
void gtk_places_sidebar_set_show_trash (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_trash);
|
2012-12-10 22:00:42 +00:00
|
|
|
|
|
2015-07-14 17:47:42 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
void gtk_places_sidebar_set_show_other_locations (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_other_locations);
|
|
|
|
|
GDK_AVAILABLE_IN_3_18
|
|
|
|
|
gboolean gtk_places_sidebar_get_show_other_locations (GtkPlacesSidebar *sidebar);
|
|
|
|
|
|
2017-07-20 15:29:42 +00:00
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
|
|
|
void gtk_places_sidebar_set_show_starred_location (GtkPlacesSidebar *sidebar,
|
|
|
|
|
gboolean show_starred_location);
|
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
|
|
|
gboolean gtk_places_sidebar_get_show_starred_location (GtkPlacesSidebar *sidebar);
|
2011-09-06 23:11:19 +00:00
|
|
|
|
G_END_DECLS
|
2011-09-06 22:53:30 +00:00
|
|
|
|
|
2011-09-06 23:11:19 +00:00
|
|
|
|
#endif /* __GTK_PLACES_SIDEBAR_H__ */
|