1 files changed, 241 insertions, 0 deletions

diff --git a/src/fs/gnunet-fs-gtk_event-handler.h b/src/fs/gnunet-fs-gtk_event-handler.h
new file mode 100644
index 00000000..064c0542
--- /dev/null
+++ b/src/fs/gnunet-fs-gtk_event-handler.h
@@ -0,0 +1,241 @@
+/*
+     This file is part of GNUnet.
+     (C) 2010 Christian Grothoff (and other contributing authors)
+
+     GNUnet 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, or (at your
+     option) any later version.
+
+     GNUnet 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 GNUnet; see the file COPYING.  If not, write to the
+     Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+     Boston, MA 02111-1307, USA.
+*/
+
+/**
+ * @file src/fs/gnunet-fs-gtk_event-handler.h
+ * @brief Main event handler for file-sharing
+ * @author Christian Grothoff
+ */
+#include "gnunet-fs-gtk-common.h"
+
+
+/**
+ * State we keep for each (search) result entry in the
+ * tree view of a search tab.
+ */
+struct SearchResult;
+
+
+/**
+ * Context we keep for a search tab.
+ */
+struct SearchTab
+{
+  /**
+   * This is a doubly-linked list.
+   */
+  struct SearchTab *next;
+
+  /**
+   * This is a doubly-linked list.
+   */
+  struct SearchTab *prev;
+
+  /**
+   * Set in case this is an inner search, otherwise NULL.
+   */
+  struct SearchResult *parent;
+
+  /**
+   * Handle for this search with FS library.
+   */
+  struct GNUNET_FS_SearchContext *sc;
+
+  /**
+   * Text of the search query.
+   */
+  char *query_txt;
+
+  /**
+   * GtkBuilder object for the search tab.
+   */ 
+  GtkBuilder *builder;
+
+  /**
+   * Frame instance of the search tab.
+   */
+  GtkWidget *frame;
+
+  /**
+   * The widget representing this search in the tab bar (not
+   * a GtkLabel, contains the actual label and the buttons).
+   */
+  GtkWidget *tab_label;
+
+  /**
+   * Button to stop and close the search.
+   */
+  GtkWidget *close_button;
+
+  /**
+   * Button to clear all entries for downloads that have completed.
+   */
+  GtkWidget *clear_button;
+
+  /**
+   * Button to resume the search.
+   */
+  GtkWidget *play_button;
+
+  /**
+   * Button to pause the search.
+   */
+  GtkWidget *pause_button;
+
+  /**
+   * Textual label in the 'tab_label'
+   */
+  GtkLabel *label;
+
+  /**
+   * Tree store with the search results.
+   */
+  GtkTreeStore *ts;
+
+  /**
+   * Number of results we got for this search.
+   */
+  unsigned int num_results;
+
+};
+
+
+/**
+ * Information we keep for each download.
+ */
+struct DownloadEntry
+{
+
+  /**
+   * Download entry of the parent (for recursive downloads),
+   * NULL if we are either a top-level download (from URI,
+   * from opened directory, orphaned from search or direct
+   * search result).
+   */
+  struct DownloadEntry *pde;
+
+  /**
+   * Associated search result, or NULL if we don't belong
+   * to a search directly (download entry).
+   */
+  struct SearchResult *sr;
+
+  /**
+   * FS handle to control the download.
+   */
+  struct GNUNET_FS_DownloadContext *dc;
+
+  /**
+   * URI for the download.
+   */
+  struct GNUNET_FS_Uri *uri;
+
+  /**
+   * Meta data for the download.
+   */
+  struct GNUNET_CONTAINER_MetaData *meta;
+
+  /**
+   * Where in the tree view is this download being displayed.
+   */
+  GtkTreeRowReference *rr;
+
+  /**
+   * Tree store where we are stored.
+   */
+  GtkTreeStore *ts;
+
+  /**
+   * Tab where this download is currently on display.
+   */
+  struct SearchTab *tab;
+
+  /**
+   * Has the download completed (or errored)?
+   */
+  int is_done;
+
+};
+
+
+/**
+ * Setup a new top-level entry in the URI/orphan tab.  If necessary, create
+ * the URI tab first.
+ *
+ * @param iter set to the new entry (OUT only)
+ * @param srp set to search result (can be NULL)
+ * @param meta metadata for the new entry
+ * @param uri URI for the new entry
+ * @return the 'uri_tab' the result was added to
+ */
+struct SearchTab *
+GNUNET_GTK_add_to_uri_tab (GtkTreeIter * iter, struct SearchResult **sr,
+                           const struct GNUNET_CONTAINER_MetaData *meta,
+                           const struct GNUNET_FS_Uri *uri);
+
+
+/**
+ * Add a search result to the given search tab.
+ *
+ * @param tab search tab to extend, never NULL
+ * @param iter set to position where search result is added (OUT only)
+ * @param parent_rr reference to parent entry in search tab, NULL for normal
+ *                  search results, 
+ * @param uri uri to add, can be NULL for top-level entry of a directory opened from disk
+ *                        (in this case, we don't know the URI and should probably not
+ *                         bother to calculate it)
+ * @param meta metadata of the entry
+ * @param result associated FS search result (can be NULL if this result
+ *                        was part of a directory)
+ * @param applicability_rank how relevant is the result
+ * @return struct representing the search result (also stored in the tree
+ *                model at 'iter')
+ */
+struct SearchResult *
+GNUNET_GTK_add_search_result (struct SearchTab *tab, 
+                              GtkTreeIter *iter,
+                              GtkTreeRowReference *parent_rr,
+                              const struct GNUNET_FS_Uri *uri,
+                              const struct GNUNET_CONTAINER_MetaData *meta,
+                              struct GNUNET_FS_SearchResult *result,
+                              uint32_t applicability_rank);
+
+
+/**
+ * Notification of FS to a client about the progress of an
+ * operation.  Callbacks of this type will be used for uploads,
+ * downloads and searches.  Some of the arguments depend a bit
+ * in their meaning on the context in which the callback is used.
+ *
+ * @param cls closure
+ * @param info details about the event, specifying the event type
+ *        and various bits about the event
+ * @return client-context (for the next progress call
+ *         for this operation; should be set to NULL for
+ *         SUSPEND and STOPPED events).  The value returned
+ *         will be passed to future callbacks in the respective
+ *         field in the GNUNET_FS_ProgressInfo struct.
+ */
+void *
+GNUNET_GTK_fs_event_handler (void *cls,
+                             const struct GNUNET_FS_ProgressInfo *info);
+
+
+/* end of gnunet-fs-gtk-event_handler.h */