src/ui/view/view.h

   1 #ifndef INKSCAPE_UI_VIEW_VIEW_H
   2 #define INKSCAPE_UI_VIEW_VIEW_H
   3
   4 /** \file
   5  * Abstract base class for all SVG document views
   6  *
   7  * Authors:
   8  *   Lauris Kaplinski <lauris@kaplinski.com>
   9  *   Ralf Stephan <ralf@ark.in-berlin.de>
  10  *
  11  * Copyright (C) 2001-2002 Lauris Kaplinski
  12  * Copyright (C) 2001 Ximian, Inc.
  13  *
  14  * Released under GNU GPL, read the file 'COPYING' for more information
  15  */
  16
  17 #include <gdk/gdktypes.h>
  18 #include <sigc++/connection.h>
  19 #include "message.h"
  20 #include "gc-managed.h"
  21 #include "gc-finalized.h"
  22 #include "gc-anchored.h"
  23
  24
  25 /**
  26  * Iterates until true or returns false.
  27  * When used as signal accumulator, stops emission if one slot returns true.
  28  */
  29 struct StopOnTrue {
  30   typedef bool result_type;
  31
  32   template<typename T_iterator>
  33   result_type operator()(T_iterator first, T_iterator last) const{
  34         for (; first != last; ++first)
  35                 if (*first) return true;
  36         return false;
  37   }
  38 };
  39
  40 /**
  41  * Iterates until nonzero or returns 0.
  42  * When used as signal accumulator, stops emission if one slot returns nonzero.
  43  */
  44 struct StopOnNonZero {
  45   typedef int result_type;
  46
  47   template<typename T_iterator>
  48   result_type operator()(T_iterator first, T_iterator last) const{
  49         for (; first != last; ++first)
  50                 if (*first) return *first;
  51         return 0;
  52   }
  53 };
  54
  55
  56 namespace NR {
  57     class Point;
  58 }
  59 class SPDocument;
  60
  61 namespace Inkscape {
  62     class MessageContext;
  63     class MessageStack;
  64     namespace UI {
  65         namespace View {
  66
  67 /**
  68  * View is an abstract base class of all UI document views.  This
  69  * includes both the editing window and the SVG preview, but does not
  70  * include the non-UI RGBA buffer-based NRArena nor the XML editor or
  71  * similar views.  The View base class has very little functionality of
  72  * its own.
  73  */
  74 class View : public GC::Managed<>,
  75              public GC::Finalized,
  76              public GC::Anchored
  77 {
  78 public:
  79
  80     View();
  81     virtual ~View();
  82
  83     void close() { _close(); }
  84
  85     /// Returns a pointer to the view's document.
  86     SPDocument *doc() const
  87       { return _doc; }
  88     /// Returns a pointer to the view's message stack.
  89     Inkscape::MessageStack *messageStack() const
  90       { return _message_stack; }
  91     /// Returns a pointer to the view's tipsMessageContext.
  92     Inkscape::MessageContext *tipsMessageContext() const
  93       { return _tips_message_context; }
  94
  95     void setPosition(gdouble x, gdouble y);
  96     void setPosition(NR::Point const &p);
  97     void emitResized(gdouble width, gdouble height);
  98     void requestRedraw();
  99
 100     // view subclasses must give implementations of these methods
 101
 102     virtual bool shutdown() = 0;
 103     virtual void mouseover() = 0;
 104     virtual void mouseout() = 0;
 105
 106     virtual void onPositionSet (double, double) = 0;
 107     virtual void onResized (double, double) = 0;
 108     virtual void onRedrawRequested() = 0;
 109     virtual void onStatusMessage (Inkscape::MessageType type, gchar const *message) = 0;
 110     virtual void onDocumentURISet (gchar const* uri) = 0;
 111     virtual void onDocumentResized (double, double) = 0;
 112
 113 protected:
 114     SPDocument *_doc;
 115     Inkscape::MessageStack *_message_stack;
 116     Inkscape::MessageContext *_tips_message_context;
 117
 118     virtual void _close();
 119     virtual void setDocument(SPDocument *doc);
 120
 121     sigc::signal<void,double,double>   _position_set_signal;
 122     sigc::signal<void,double,double>   _resized_signal;
 123     sigc::signal<void,gchar const*>    _document_uri_set_signal;
 124     sigc::signal<void>                 _redraw_requested_signal;
 125
 126 private:
 127     sigc::connection _position_set_connection;
 128     sigc::connection _resized_connection;
 129     sigc::connection _redraw_requested_connection;
 130     sigc::connection _message_changed_connection;  // foreign
 131     sigc::connection _document_uri_set_connection; // foreign
 132     sigc::connection _document_resized_connection; // foreign
 133 };
 134
 135 }}}
 136
 137 #endif  // INKSCAPE_UI_VIEW_VIEW_H
 138
 139 /*
 140   Local Variables:
 141   mode:c++
 142   c-file-style:"stroustrup"
 143   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
 144   indent-tabs-mode:nil
 145   fill-column:99
 146   End:
 147 */
 148 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :