/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */

/* caja-dnd.h - Common Drag & drop handling code shared by the icon container
   and the list view.

   Copyright (C) 2000 Eazel, Inc.

   The Mate 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.

   The Mate 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 Library General Public
   License along with the Mate Library; see the file COPYING.LIB.  If not,
   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.

   Authors: Pavel Cisler <pavel@eazel.com>,
	    Ettore Perazzoli <ettore@gnu.org>
*/

#ifndef CAJA_DND_H
#define CAJA_DND_H

#include <gtk/gtk.h>
#include <libcaja-private/caja-window-slot-info.h>

/* Drag & Drop target names. */
#define CAJA_ICON_DND_MATE_ICON_LIST_TYPE	"x-special/mate-icon-list"
#define CAJA_ICON_DND_URI_LIST_TYPE		"text/uri-list"
#define CAJA_ICON_DND_NETSCAPE_URL_TYPE	"_NETSCAPE_URL"
#define CAJA_ICON_DND_COLOR_TYPE		"application/x-color"
#define CAJA_ICON_DND_BGIMAGE_TYPE		"property/bgimage"
#define CAJA_ICON_DND_KEYWORD_TYPE		"property/keyword"
#define CAJA_ICON_DND_RESET_BACKGROUND_TYPE "x-special/mate-reset-background"
#define CAJA_ICON_DND_ROOTWINDOW_DROP_TYPE	"application/x-rootwindow-drop"
#define CAJA_ICON_DND_XDNDDIRECTSAVE_TYPE	"XdndDirectSave0" /* XDS Protocol Type */
#define CAJA_ICON_DND_RAW_TYPE	"application/octet-stream"

/* Item of the drag selection list */
typedef struct
{
    char *uri;
    gboolean got_icon_position;
    int icon_x, icon_y;
    int icon_width, icon_height;
} CajaDragSelectionItem;

/* Standard Drag & Drop types. */
typedef enum
{
    CAJA_ICON_DND_MATE_ICON_LIST,
    CAJA_ICON_DND_URI_LIST,
    CAJA_ICON_DND_NETSCAPE_URL,
    CAJA_ICON_DND_COLOR,
    CAJA_ICON_DND_BGIMAGE,
    CAJA_ICON_DND_KEYWORD,
    CAJA_ICON_DND_TEXT,
    CAJA_ICON_DND_RESET_BACKGROUND,
    CAJA_ICON_DND_XDNDDIRECTSAVE,
    CAJA_ICON_DND_RAW,
    CAJA_ICON_DND_ROOTWINDOW_DROP
} CajaIconDndTargetType;

typedef enum
{
    CAJA_DND_ACTION_FIRST = GDK_ACTION_ASK << 1,
    CAJA_DND_ACTION_SET_AS_BACKGROUND = CAJA_DND_ACTION_FIRST << 0,
    CAJA_DND_ACTION_SET_AS_FOLDER_BACKGROUND = CAJA_DND_ACTION_FIRST << 1,
    CAJA_DND_ACTION_SET_AS_GLOBAL_BACKGROUND = CAJA_DND_ACTION_FIRST << 2
} CajaDndAction;

/* drag&drop-related information. */
typedef struct
{
    GtkTargetList *target_list;

    /* Stuff saved at "receive data" time needed later in the drag. */
    gboolean got_drop_data_type;
    CajaIconDndTargetType data_type;
    GtkSelectionData *selection_data;
    char *direct_save_uri;

    /* Start of the drag, in window coordinates. */
    int start_x, start_y;

    /* List of CajaDragSelectionItems, representing items being dragged, or NULL
     * if data about them has not been received from the source yet.
     */
    GList *selection_list;

    /* has the drop occured ? */
    gboolean drop_occured;

    /* whether or not need to clean up the previous dnd data */
    gboolean need_to_destroy;

    /* autoscrolling during dragging */
    int auto_scroll_timeout_id;
    gboolean waiting_to_autoscroll;
    gint64 start_auto_scroll_in;

} CajaDragInfo;

typedef struct
{
    /* NB: the following elements are managed by us */
    gboolean have_data;
    gboolean have_valid_data;

    gboolean drop_occured;

    unsigned int info;
    union
    {
        GList *selection_list;
        GList *uri_list;
        char *netscape_url;
    } data;

    /* NB: the following elements are managed by the caller of
     *   caja_drag_slot_proxy_init() */

    /* a fixed location, or NULL to use slot's location */
    GFile *target_location;
    /* a fixed slot, or NULL to use the window's active slot */
    CajaWindowSlotInfo *target_slot;
} CajaDragSlotProxyInfo;

typedef void		(* CajaDragEachSelectedItemDataGet)	(const char *url,
        int x, int y, int w, int h,
        gpointer data);
typedef void		(* CajaDragEachSelectedItemIterator)	(CajaDragEachSelectedItemDataGet iteratee,
        gpointer iterator_context,
        gpointer data);

void			    caja_drag_init				(CajaDragInfo		      *drag_info,
        const GtkTargetEntry		      *drag_types,
        int				       drag_type_count,
        gboolean			       add_text_targets);
void			    caja_drag_finalize			(CajaDragInfo		      *drag_info);
CajaDragSelectionItem  *caja_drag_selection_item_new		(void);
void			    caja_drag_destroy_selection_list	(GList				      *selection_list);
GList			   *caja_drag_build_selection_list		(GtkSelectionData		      *data);

char **			    caja_drag_uri_array_from_selection_list (const GList			      *selection_list);
GList *			    caja_drag_uri_list_from_selection_list	(const GList			      *selection_list);

char **			    caja_drag_uri_array_from_list		(const GList			      *uri_list);
GList *			    caja_drag_uri_list_from_array		(const char			     **uris);

gboolean		    caja_drag_items_local			(const char			      *target_uri,
        const GList			      *selection_list);
gboolean		    caja_drag_uris_local			(const char			      *target_uri,
        const GList			      *source_uri_list);
gboolean		    caja_drag_items_in_trash		(const GList			      *selection_list);
gboolean		    caja_drag_items_on_desktop		(const GList			      *selection_list);
void			    caja_drag_default_drop_action_for_icons (GdkDragContext			      *context,
        const char			      *target_uri,
        const GList			      *items,
        int				      *action);
GdkDragAction		    caja_drag_default_drop_action_for_netscape_url (GdkDragContext			     *context);
GdkDragAction		    caja_drag_default_drop_action_for_uri_list     (GdkDragContext			     *context,
        const char			     *target_uri_string);
gboolean		    caja_drag_drag_data_get			(GtkWidget			      *widget,
        GdkDragContext			      *context,
        GtkSelectionData		      *selection_data,
        guint				       info,
        guint32			       time,
        gpointer			       container_context,
        CajaDragEachSelectedItemIterator  each_selected_item_iterator);
int			    caja_drag_modifier_based_action		(int				       default_action,
        int				       non_default_action);

GdkDragAction		    caja_drag_drop_action_ask		(GtkWidget			      *widget,
        GdkDragAction			       possible_actions);
GdkDragAction		    caja_drag_drop_background_ask		(GtkWidget			      *widget,
        GdkDragAction			       possible_actions);

gboolean		    caja_drag_autoscroll_in_scroll_region	(GtkWidget			      *widget);
void			    caja_drag_autoscroll_calculate_delta	(GtkWidget			      *widget,
        float				      *x_scroll_delta,
        float				      *y_scroll_delta);
void			    caja_drag_autoscroll_start		(CajaDragInfo		      *drag_info,
        GtkWidget			      *widget,
        GtkFunction			       callback,
        gpointer			       user_data);
void			    caja_drag_autoscroll_stop		(CajaDragInfo		      *drag_info);

gboolean		    caja_drag_selection_includes_special_link (GList			      *selection_list);

void                        caja_drag_slot_proxy_init               (GtkWidget *widget,
        CajaDragSlotProxyInfo *drag_info);

#endif
