LUMIERA.clone/src/gui/widgets/timeline/header-container.hpp

/*
  header-container.hpp  -  Declaration of the header container widget
 
  Copyright (C)         Lumiera.org
    2008,               Joel Holdsworth <joel@airwebreathe.org.uk>
 
  This program 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 of the
  License, or (at your option) any later version.
 
  This program 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 this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
*/
/** @file header-container.hpp
 ** This file contains the definition of the header container
 ** widget
 */

#ifndef HEADER_CONTAINER_HPP
#define HEADER_CONTAINER_HPP

#include <gtkmm.h>
#include <vector>

namespace lumiera {
namespace gui {
namespace widgets {

class TimelineWidget;

namespace timeline {

class Track;

/**
 * A helper class for the TimelineWidget. HeaderContainer is
 * container widget for all the left-hand-side header widgets
 * associated with timeline tracks.
 */
class HeaderContainer : public Gtk::Container
{
public:
  /**
   * Constructor
   *
   * @param[in] timeline_widget A pointer to the owner timeline widget
   */
  HeaderContainer(lumiera::gui::widgets::TimelineWidget *timeline_widget);
  
  /**
   * Attaches the header all the header widgets of root
   * tracks to this control.
   *
   * @note This must be called when the track list changes
   * to synchronise the headers with the timeline body and
   * the backend.
   */
  void update_headers();

  /* ===== Overrides ===== */
private:
  void on_realize();
  void on_unrealize();

  void on_size_allocate (Gtk::Allocation& allocation);
  void on_size_request (Gtk::Requisition* requisition);
      
  void forall_vfunc(gboolean include_internals, GtkCallback callback,
                    gpointer callback_data);
  
  /* ===== Events ===== */      
private:         
  void on_scroll();
    
  /* ===== Internals ===== */
private:

  /**
   * Moves all the header widgets to the correct position
   * given scroll, stacking etc.
   */
  void layout_headers();
  
private:

  /**
   * The owner TimelineWidget of which this class is a helper
   */
  lumiera::gui::widgets::TimelineWidget *timelineWidget;

  /**
   * A structure to represent a header widget and it's
   * associated track
   */
  struct RootHeader
  {
    Glib::RefPtr<Gtk::Widget> widget;
    Track *track;
  };
  
  /**
   * Contains a list of the root currently present on
   * the timeline view
   */
  std::vector< RootHeader > rootHeaders;

  /**
   * The widget's window object. 
   * 
   * @note This is needed for the sake of clipping when
   * widgets are scrolled.
   */
  Glib::RefPtr<Gdk::Window> gdkWindow;
};

}   // namespace timeline
}   // namespace widgets
}   // namespace gui
}   // namespace lumiera

#endif // HEADER_CONTAINER_HPP