shell/ev-view.h

   1 /* this file is part of evince, a gnome document viewer
   2  *
   3  *  Copyright (C) 2004 Red Hat, Inc
   4  *
   5  * Evince is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * Evince is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
  18  */
  19
  20 #ifndef __EV_VIEW_H__
  21 #define __EV_VIEW_H__
  22
  23 #include <gtk/gtkwidget.h>
  24 #include <gtk/gtklayout.h>
  25 #include <gtk/gtkscrolledwindow.h>
  26
  27 #include "ev-document.h"
  28 #include "ev-link.h"
  29 #include "ev-view-accessible.h"
  30
  31 G_BEGIN_DECLS
  32
  33 #define EV_TYPE_VIEW            (ev_view_get_type ())
  34 #define EV_VIEW(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), EV_TYPE_VIEW, EvView))
  35 #define EV_IS_VIEW(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), EV_TYPE_VIEW))
  36
  37 #define EV_TYPE_SIZING_MODE     (ev_sizing_mode_get_type())
  38 #define EV_SIZING_MODE_CLASS    (g_type_class_peek (EV_TYPE_SIZING_MODE))
  39
  40 #define EV_TYPE_SCROLL_TYPE     (ev_scroll_type_get_type())
  41 #define EV_SCROLL_TYPE_CLASS    (g_type_class_peek (EV_TYPE_SCROLL_TYPE))
  42
  43 typedef struct _EvView       EvView;
  44 typedef struct _EvViewClass  EvViewClass;
  45
  46
  47 typedef enum {
  48         EV_SIZING_BEST_FIT,
  49         EV_SIZING_FIT_WIDTH,
  50         EV_SIZING_FREE,
  51 } EvSizingMode;
  52
  53 typedef enum {
  54         EV_VIEW_SELECTION_TEXT,
  55         EV_VIEW_SELECTION_RECTANGLE,
  56 } EvViewSelectionMode;
  57
  58 typedef enum {
  59         EV_SCROLL_PAGE_FORWARD,
  60         EV_SCROLL_PAGE_BACKWARD,
  61         EV_SCROLL_STEP_BACKWARD,
  62         EV_SCROLL_STEP_FORWARD,
  63         EV_SCROLL_STEP_DOWN,
  64         EV_SCROLL_STEP_UP,
  65 } EvScrollType;
  66
  67 GType           ev_view_get_type          (void) G_GNUC_CONST;
  68 GType           ev_sizing_mode_get_type   (void) G_GNUC_CONST;
  69 GType           ev_scroll_type_get_type   (void) G_GNUC_CONST;
  70
  71 GtkWidget*      ev_view_new               (void);
  72 void            ev_view_set_document      (EvView         *view,
  73                                            EvDocument     *document);
  74 void            ev_view_set_loading       (EvView         *view,
  75                                            gboolean        loading);
  76
  77 /* Clipboard */
  78 void            ev_view_copy              (EvView         *view);
  79 void            ev_view_select_all        (EvView         *view);
  80 gboolean        ev_view_get_has_selection (EvView         *view);
  81
  82 /* sizing and behavior */
  83 /* These are all orthoganal to each other, except 'presentation' trumps all
  84  * other behaviors
  85  */
  86 gboolean        ev_view_get_continuous    (EvView         *view);
  87 void            ev_view_set_continuous    (EvView         *view,
  88                                            gboolean        continuous);
  89 gboolean        ev_view_get_dual_page     (EvView         *view);
  90 void            ev_view_set_dual_page     (EvView         *view,
  91                                            gboolean        dual_page);
  92 void            ev_view_set_fullscreen    (EvView         *view,
  93                                            gboolean        fullscreen);
  94 gboolean        ev_view_get_fullscreen    (EvView         *view);
  95 void            ev_view_set_presentation  (EvView         *view,
  96                                            gboolean        presentation);
  97 gboolean        ev_view_get_presentation  (EvView         *view);
  98 void            ev_view_set_sizing_mode   (EvView         *view,
  99                                            EvSizingMode    mode);
 100 EvSizingMode    ev_view_get_sizing_mode   (EvView         *view);
 101
 102
 103 /* Page size */
 104 gboolean        ev_view_can_zoom_in       (EvView         *view);
 105 void            ev_view_zoom_in           (EvView         *view);
 106 gboolean        ev_view_can_zoom_out      (EvView         *view);
 107 void            ev_view_zoom_out          (EvView         *view);
 108 void            ev_view_set_zoom          (EvView         *view,
 109                                            double          factor,
 110                                            gboolean        relative);
 111 double          ev_view_get_zoom          (EvView         *view);
 112 void            ev_view_set_screen_dpi    (EvView         *view,
 113                                            gdouble         dpi);
 114 void            ev_view_rotate_left       (EvView         *view);
 115 void            ev_view_rotate_right      (EvView         *view);
 116 void            ev_view_set_rotation      (EvView         *view,
 117                                            int             rotation);
 118 int             ev_view_get_rotation      (EvView         *view);
 119
 120 /* Find */
 121 gboolean        ev_view_can_find_next        (EvView         *view);
 122 void            ev_view_find_next            (EvView         *view);
 123 gboolean        ev_view_can_find_previous    (EvView         *view);
 124 void            ev_view_find_previous        (EvView         *view);
 125 void            ev_view_search_changed       (EvView         *view);
 126 void            ev_view_set_highlight_search (EvView         *view,
 127                                               gboolean        value);
 128 /* Status */
 129 const char     *ev_view_get_status        (EvView         *view);
 130 const char     *ev_view_get_find_status   (EvView         *view);
 131
 132 /* Cursor */
 133 void           ev_view_hide_cursor        (EvView         *view);
 134 void           ev_view_show_cursor        (EvView         *view);
 135
 136 /* Navigation */
 137 void           ev_view_scroll             (EvView         *view,
 138                                            EvScrollType    scroll,
 139                                            gboolean        horizontal);
 140 void           ev_view_handle_link        (EvView         *view,
 141                                            EvLink         *link);
 142 gboolean       ev_view_next_page          (EvView         *view);
 143 gboolean       ev_view_previous_page      (EvView         *view);
 144 gchar*         ev_view_page_label_from_dest (EvView *view, EvLinkDest *dest);
 145
 146 void           ev_view_update_view_size (EvView *view, GtkScrolledWindow *scrolled_window);
 147
 148 G_END_DECLS
 149
 150 #endif /* __EV_VIEW_H__ */