/*
 * e-selection.h
 *
 * 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 of the License, or (at your option) version 3.
 *
 * 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.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with the program; if not, see <http://www.gnu.org/licenses/>
 *
 *
 * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
 *
 */

/**
 * SECTION: e-selection
 * @short_description: selection and clipboard utilities
 * @include: e-util/e-selection.h
 **/

#ifndef E_SELECTION_H
#define E_SELECTION_H

#include <gtk/gtk.h>

/* This API mimics GTK's API for dealing with text, image and URI data. */

G_BEGIN_DECLS

/* Selection Functions */

void		e_target_list_add_calendar_targets
					(GtkTargetList *list,
					 guint info);
void		e_target_list_add_directory_targets
					(GtkTargetList *list,
					 guint info);
void		e_target_list_add_html_targets
					(GtkTargetList *list,
					 guint info);
gboolean	e_selection_data_set_calendar
					(GtkSelectionData *selection_data,
					 const gchar *source,
					 gint length);
gboolean	e_selection_data_set_directory
					(GtkSelectionData *selection_data,
					 const gchar *source,
					 gint length);
gboolean	e_selection_data_set_html
					(GtkSelectionData *selection_data,
					 const gchar *source,
					 gint length);
gchar *		e_selection_data_get_calendar
					(GtkSelectionData *selection_data);
gchar *		e_selection_data_get_directory
					(GtkSelectionData *selection_data);
gchar *		e_selection_data_get_html
					(GtkSelectionData *selection_data);
gboolean	e_selection_data_targets_include_calendar
					(GtkSelectionData *selection_data);
gboolean	e_selection_data_targets_include_directory
					(GtkSelectionData *selection_data);
gboolean	e_selection_data_targets_include_html
					(GtkSelectionData *selection_data);
gboolean	e_targets_include_calendar
					(GdkAtom *targets,
					 gint n_targets);
gboolean	e_targets_include_directory
					(GdkAtom *targets,
					 gint n_targets);
gboolean	e_targets_include_html	(GdkAtom *targets,
					 gint n_targets);

/* Clipboard Functions */

void		e_clipboard_set_calendar(GtkClipboard *clipboard,
					 const gchar *source,
					 gint length);
void		e_clipboard_set_directory
					(GtkClipboard *clipboard,
					 const gchar *source,
					 gint length);
void		e_clipboard_set_html	(GtkClipboard *clipboard,
					 const gchar *source,
					 gint length);
void		e_clipboard_request_calendar
					(GtkClipboard *clipboard,
					 GtkClipboardTextReceivedFunc callback,
					 gpointer user_data);
void		e_clipboard_request_directory
					(GtkClipboard *clipboard,
					 GtkClipboardTextReceivedFunc callback,
					 gpointer user_data);
void		e_clipboard_request_html(GtkClipboard *clipboard,
					 GtkClipboardTextReceivedFunc callback,
					 gpointer user_data);
gchar *		e_clipboard_wait_for_calendar
					(GtkClipboard *clipboard);
gchar *		e_clipboard_wait_for_directory
					(GtkClipboard *clipboard);
gchar *		e_clipboard_wait_for_html
					(GtkClipboard *clipboard);
gboolean	e_clipboard_wait_is_calendar_available
					(GtkClipboard *clipboard);
gboolean	e_clipboard_wait_is_directory_available
					(GtkClipboard *clipboard);
gboolean	e_clipboard_wait_is_html_available
					(GtkClipboard *clipboard);

/* Drag and Drop Functions */

void		e_drag_dest_add_calendar_targets
					(GtkWidget *widget);
void		e_drag_dest_add_directory_targets
					(GtkWidget *widget);
void		e_drag_dest_add_html_targets
					(GtkWidget *widget);
void		e_drag_source_add_calendar_targets
					(GtkWidget *widget);
void		e_drag_source_add_directory_targets
					(GtkWidget *widget);
void		e_drag_source_add_html_targets
					(GtkWidget *widget);

G_END_DECLS

#endif /* E_SELECTION_H */