libempathy-gtk/empathy-individual-view.h

   1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
   2 /*
   3  * Copyright (C) 2005-2007 Imendio AB
   4  * Copyright (C) 2007-2010 Collabora Ltd.
   5  *
   6  * This program is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU General Public License as
   8  * published by the Free Software Foundation; either version 2 of the
   9  * License, or (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public
  17  * License along with this program; if not, write to the
  18  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  19  * Boston, MA  02110-1301  USA
  20  *
  21  * Authors: Mikael Hallendal <micke@imendio.com>
  22  *          Martyn Russell <martyn@imendio.com>
  23  *          Xavier Claessens <xclaesse@gmail.com>
  24  *          Travis Reitter <travis.reitter@collabora.co.uk>
  25  */
  26
  27 #ifndef __EMPATHY_INDIVIDUAL_VIEW_H__
  28 #define __EMPATHY_INDIVIDUAL_VIEW_H__
  29
  30 #include <gtk/gtk.h>
  31
  32 #include <folks/folks.h>
  33
  34 #include <libempathy/empathy-enum-types.h>
  35
  36 #include "empathy-live-search.h"
  37 #include "empathy-individual-menu.h"
  38 #include "empathy-individual-store.h"
  39
  40 G_BEGIN_DECLS
  41 #define EMPATHY_TYPE_INDIVIDUAL_VIEW         (empathy_individual_view_get_type ())
  42 #define EMPATHY_INDIVIDUAL_VIEW(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), EMPATHY_TYPE_INDIVIDUAL_VIEW, EmpathyIndividualView))
  43 #define EMPATHY_INDIVIDUAL_VIEW_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), EMPATHY_TYPE_INDIVIDUAL_VIEW, EmpathyIndividualViewClass))
  44 #define EMPATHY_IS_INDIVIDUAL_VIEW(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), EMPATHY_TYPE_INDIVIDUAL_VIEW))
  45 #define EMPATHY_IS_INDIVIDUAL_VIEW_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), EMPATHY_TYPE_INDIVIDUAL_VIEW))
  46 #define EMPATHY_INDIVIDUAL_VIEW_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), EMPATHY_TYPE_INDIVIDUAL_VIEW, EmpathyIndividualViewClass))
  47 typedef struct _EmpathyIndividualView EmpathyIndividualView;
  48 typedef struct _EmpathyIndividualViewClass EmpathyIndividualViewClass;
  49
  50 typedef enum
  51 {
  52   EMPATHY_INDIVIDUAL_VIEW_FEATURE_NONE = 0,
  53   EMPATHY_INDIVIDUAL_VIEW_FEATURE_GROUPS_SAVE = 1 << 0,
  54   EMPATHY_INDIVIDUAL_VIEW_FEATURE_GROUPS_RENAME = 1 << 1,
  55   EMPATHY_INDIVIDUAL_VIEW_FEATURE_GROUPS_REMOVE = 1 << 2,
  56   /* NOTE: For this to behave as expected, FEATURE_INDIVIDUAL_DRAG and
  57    * FEATURE_INDIVIDUAL_DROP should also be specified. */
  58   EMPATHY_INDIVIDUAL_VIEW_FEATURE_GROUPS_CHANGE = 1 << 3,
  59   EMPATHY_INDIVIDUAL_VIEW_FEATURE_INDIVIDUAL_REMOVE = 1 << 4,
  60   EMPATHY_INDIVIDUAL_VIEW_FEATURE_INDIVIDUAL_DROP = 1 << 5,
  61   EMPATHY_INDIVIDUAL_VIEW_FEATURE_INDIVIDUAL_DRAG = 1 << 6,
  62   EMPATHY_INDIVIDUAL_VIEW_FEATURE_INDIVIDUAL_TOOLTIP = 1 << 7,
  63   EMPATHY_INDIVIDUAL_VIEW_FEATURE_INDIVIDUAL_CALL = 1 << 8,
  64   EMPATHY_INDIVIDUAL_VIEW_FEATURE_PERSONA_DROP = 1 << 9,
  65   EMPATHY_INDIVIDUAL_VIEW_FEATURE_FILE_DROP = 1 << 10,
  66   EMPATHY_INDIVIDUAL_VIEW_FEATURE_ALL = (1 << 11) - 1,
  67 } EmpathyIndividualViewFeatureFlags;
  68
  69 struct _EmpathyIndividualView
  70 {
  71   GtkTreeView parent;
  72   gpointer priv;
  73 };
  74
  75 struct _EmpathyIndividualViewClass
  76 {
  77   GtkTreeViewClass parent_class;
  78
  79   void (* drag_individual_received) (EmpathyIndividualView *self,
  80       GdkDragAction action,
  81       FolksIndividual *individual,
  82       const gchar *new_group,
  83       const gchar *old_group);
  84
  85   void (* drag_persona_received) (EmpathyIndividualView *self,
  86       GdkDragAction action,
  87       FolksPersona *persona,
  88       FolksIndividual *individual);
  89 };
  90
  91 GType empathy_individual_view_get_type (void) G_GNUC_CONST;
  92
  93 EmpathyIndividualView *empathy_individual_view_new (
  94     EmpathyIndividualStore *store,
  95     EmpathyIndividualViewFeatureFlags view_features,
  96     EmpathyIndividualFeatureFlags individual_features);
  97
  98 FolksIndividual *empathy_individual_view_dup_selected (
  99     EmpathyIndividualView *view);
 100
 101 GtkWidget *empathy_individual_view_get_individual_menu (
 102     EmpathyIndividualView *view);
 103
 104 GtkWidget *empathy_individual_view_get_group_menu (EmpathyIndividualView *view);
 105
 106 void empathy_individual_view_set_live_search (EmpathyIndividualView *view,
 107     EmpathyLiveSearch *search);
 108
 109 gboolean empathy_individual_view_get_show_offline (
 110     EmpathyIndividualView *view);
 111
 112 void empathy_individual_view_set_show_offline (
 113     EmpathyIndividualView *view,
 114     gboolean show_offline);
 115
 116 gboolean empathy_individual_view_get_show_untrusted (
 117     EmpathyIndividualView *self);
 118
 119 void empathy_individual_view_set_show_untrusted (EmpathyIndividualView *self,
 120     gboolean show_untrusted);
 121
 122 gboolean empathy_individual_view_is_searching (
 123     EmpathyIndividualView *view);
 124
 125 EmpathyIndividualStore *empathy_individual_view_get_store (
 126     EmpathyIndividualView *self);
 127 void empathy_individual_view_set_store (EmpathyIndividualView *self,
 128     EmpathyIndividualStore *store);
 129
 130 void empathy_individual_view_start_search (EmpathyIndividualView *self);
 131
 132 void empathy_individual_view_set_custom_filter (EmpathyIndividualView *self,
 133     GtkTreeModelFilterVisibleFunc filter,
 134     gpointer data);
 135
 136 void empathy_individual_view_refilter (EmpathyIndividualView *self);
 137
 138 void empathy_individual_view_select_first (EmpathyIndividualView *self);
 139
 140 G_END_DECLS
 141 #endif /* __EMPATHY_INDIVIDUAL_VIEW_H__ */