table.h

// table.h   -*-c++-*-

#ifndef TABLE_H
#define TABLE_H

#include "passthrough.h"
#include <list>
#include <vector>

#include <sigc++/connection.h>

namespace cwidget
{
  namespace widgets
  {
    class keybindings;

    class table:public passthrough
    {
    public:
      // Options for laying out the widget..
      static const int EXPAND=0x1, SHRINK=0x2, FILL=0x4;
      static const int ALIGN_LEFT=0x8, ALIGN_RIGHT=0x10;
      static const int ALIGN_CENTER=ALIGN_LEFT|ALIGN_RIGHT;
      static const int IGNORE_SIZE_REQUEST=0x20;
    private:
      struct child_info
      {
        // The widget itself
        widget_ref w;

        // The upper-left corner of this widget
        int row_start, col_start;

        // How big is it?
        int row_span, col_span;

        int alloc_w, alloc_h;

        int request_w, request_h;

        sigc::connection shown_conn, hidden_conn;

        bool expand_x:1, expand_y:1;

        bool fill_x:1, fill_y:1;

        bool shrink_x:1, shrink_y:1;

        bool align_left_x:1, align_left_y:1, align_right_x:1, align_right_y:1;

        bool ignore_size_x:1, ignore_size_y:1;

        child_info(const widget_ref &_w, int _row_start, int _col_start,
                   int _row_span, int _col_span, int xopts, int yopts,
                   sigc::connection &_shown_conn, sigc::connection &_hidden_conn);
      };

      bool lies_on_axis(const child_info &base,
                        bool horizontal,
                        const child_info &c);
      class better_fit;
      class nrow_lt;
      class ncol_lt;

      typedef std::list<child_info> childlist;

      // Tables have an automatic behavior similar to dialogs in other widget
      // sets -- they can give the focus to any widget that can handle it.
      //
      // Widgets are given focus in the order in which they are added to the
      // table (cyclically)
      childlist children;
      childlist::iterator focus;

      // Separation between rows/columns; initially 0.
      int rowsep, colsep;

      void calc_dimensions();

      int num_rows;

      int num_cols;

      void layout_me();

      // Focus-handling stuff
      widget_ref get_focus();
      void hide_widget(const widget_ref &w);
      void hide_widget_bare(widget &w);
      void show_widget(const widget_ref &w);
      void show_widget_bare(widget &w);

      void get_row_contents(std::vector<std::vector<child_info *> > row_contents);

      void get_col_contents(std::vector<std::vector<child_info *> > col_contents);

      void alloc_ideal_widths(std::vector<int> &col_sizes);
      void expand_widths(std::vector<int> &col_sizes, int target_w);
      void shrink_widths(std::vector<int> &col_sizes, int target_w);
      void alloc_ideal_heights(std::vector<int> &row_sizes,
                               const std::vector<int> &col_sizes);
      void expand_heights(std::vector<int> &row_sizes, int target_h);
      void shrink_heights(std::vector<int> &row_sizes, int target_h);
      void alloc_child_sizes(const std::vector<int> &col_sizes,
                             const std::vector<int> &row_sizes);



      void got_focus();
      void lost_focus();

      // Moves the focus in the given direction
      childlist::iterator find_best_focus(childlist::iterator start,
                                          int dx,
                                          int dy);

    protected:
      bool handle_key(const config::key &k);
      table();

    public:
      static util::ref_ptr<table> create()
      {
        util::ref_ptr<table> rval(new table);
        rval->decref();
        return rval;
      }

      ~table();

      void destroy();

      void add_widget_opts(const widget_ref &w, int row_start, int col_start, int row_span, int col_span, int xopts, int yopts);
      void add_widget_opts_bare(widget &w, int row_start, int col_start, int row_span, int col_span, int xopts, int yopts);

      void add_widget(const widget_ref &w, int row_start, int col_start, int row_span=1, int col_span=1, bool expand=true, bool shrink=true);
      void add_widget_bare(widget &w, int row_start, int col_start, int row_span=1, int col_span=1, bool expand=true, bool shrink=true);

      void add_widget(const widget_ref &w);

      void rem_widget(const widget_ref &w);

      void focus_widget(const widget_ref &w);
      void focus_widget_bare(widget &w);

      void set_rowsep(int n);

      void set_colsep(int n);

      void show_all();

      int width_request();

      int height_request(int w);

      void paint(const style &st);
      void dispatch_mouse(short id, int x, int y, int z, mmask_t bstate);

      static config::keybindings *bindings;
      static void init_bindings();
    };

    typedef util::ref_ptr<table> table_ref;
  }
}

#endif