src/ui/widget/dock.h

   1 /**
   2  * \brief A desktop dock pane to dock dialogs, a custom wrapper around gdl-dock.
   3  *
   4  * Author:
   5  *   Gustav Broberg <broberg@kth.se>
   6  *
   7  * Copyright (C) 2007 Authors
   8  *
   9  * Released under GNU GPL.  Read the file 'COPYING' for more information.
  10  */
  11
  12 #ifndef INKSCAPE_UI_WIDGET_DOCK_H
  13 #define INKSCAPE_UI_WIDGET_DOCK_H
  14
  15 #include <gtkmm/scrolledwindow.h>
  16 #include <gtkmm/box.h>
  17 #include <gtkmm/paned.h>
  18
  19 #include <list>
  20
  21 #include "ui/widget/dock-item.h"
  22
  23 #include "libgdl/libgdl.h"
  24
  25 namespace Inkscape {
  26 namespace UI {
  27 namespace Widget {
  28
  29 class Dock {
  30
  31 public:
  32
  33     Dock(Gtk::Orientation orientation=Gtk::ORIENTATION_VERTICAL);
  34     ~Dock();
  35
  36     void addItem(DockItem& item, DockItem::Placement placement);
  37
  38     Gtk::Widget& getWidget();     //< return the top widget
  39     Gtk::Paned *getParentPaned();
  40
  41     Gtk::Paned *getPaned();
  42
  43     bool isEmpty() const;     //< true iff none of the dock's items are in state != UNATTACHED
  44     bool hasIconifiedItems() const;
  45
  46     Glib::SignalProxy0<void> signal_layout_changed();
  47
  48     void hide();
  49     void show();
  50
  51     /** Toggle size of dock between the previous dimensions and the ones sent as parameters */
  52     void toggleDockable(int width=0, int height=0);
  53
  54     /** Scrolls the scrolled window container to make the provided dock item visible, if needed */
  55     void scrollToItem(DockItem& item);
  56
  57 protected:
  58
  59     std::list<const DockItem *> _dock_items;   //< added dock items
  60
  61     /** Interface widgets, will be packed like
  62      * _scrolled_window -> (_dock_box -> (_paned -> (_dock -> _filler) | _dock_bar))
  63      */
  64     Gtk::Box *_dock_box;
  65     Gtk::Paned* _paned;
  66     GdlDock *_gdl_dock;
  67     GdlDockBar *_gdl_dock_bar;
  68     Gtk::VBox _filler;
  69     Gtk::ScrolledWindow *_scrolled_window;
  70
  71     /** Internal signal handlers */
  72     void _onLayoutChanged();
  73
  74     /** GdlDock signal proxy structures */
  75     static const Glib::SignalProxyInfo _signal_layout_changed_proxy;
  76
  77     /** Standard widths */
  78     static const int _default_empty_width;
  79     static const int _default_dock_bar_width;
  80 };
  81
  82 } // namespace Widget
  83 } // namespace UI
  84 } // namespace Inkscape
  85
  86 #endif //INKSCAPE_UI_DIALOG_BEHAVIOUR_H
  87
  88 /*
  89   Local Variables:
  90   mode:c++
  91   c-file-style:"stroustrup"
  92   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
  93   indent-tabs-mode:nil
  94   fill-column:99
  95   End:
  96 */
  97 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99
  98