lib/gtksheet/gtksheet.h

   1 /* This version of GtkSheet has been heavily modified, for the specific
   2    requirements of PSPPIRE. */
   3
   4
   5 /* GtkSheet widget for Gtk+.
   6  * Copyright (C) 1999-2001 Adrian E. Feiguin <adrian@ifir.ifir.edu.ar>
   7  *
   8  * Based on GtkClist widget by Jay Painter, but major changes.
   9  * Memory allocation routines inspired on SC (Spreadsheet Calculator)
  10  *
  11  * This library is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU Lesser General Public
  13  * License as published by the Free Software Foundation; either
  14  * version 2.1 of the License, or (at your option) any later version.
  15  *
  16  * This library is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19  * Lesser General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU Lesser General Public
  22  * License along with this library; if not, write to the Free Software
  23  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  24  */
  25
  26 #ifndef __GTK_SHEET_H__
  27 #define __GTK_SHEET_H__
  28
  29 #include <gtk/gtk.h>
  30
  31 #include "gtkextra-sheet.h"
  32 #include "gsheetmodel.h"
  33 #include "psppire-axis.h"
  34
  35 G_BEGIN_DECLS
  36
  37 /* sheet->state */
  38 enum
  39 {
  40   GTK_SHEET_NORMAL,
  41   GTK_SHEET_ROW_SELECTED,
  42   GTK_SHEET_COLUMN_SELECTED,
  43   GTK_SHEET_RANGE_SELECTED
  44 };
  45
  46
  47 #define GTK_TYPE_SHEET_RANGE (gtk_sheet_range_get_type ())
  48 #define GTK_TYPE_SHEET_CELL (gtk_sheet_cell_get_type ())
  49 #define GTK_TYPE_SHEET (gtk_sheet_get_type ())
  50
  51 #define GTK_SHEET(obj)          GTK_CHECK_CAST (obj, gtk_sheet_get_type (), GtkSheet)
  52 #define GTK_SHEET_CLASS(klass)  GTK_CHECK_CLASS_CAST (klass, gtk_sheet_get_type (), GtkSheetClass)
  53 #define GTK_IS_SHEET(obj)       GTK_CHECK_TYPE (obj, gtk_sheet_get_type ())
  54
  55
  56 typedef struct _GtkSheetClass GtkSheetClass;
  57 typedef struct _GtkSheetCellAttr     GtkSheetCellAttr;
  58
  59 typedef struct _GtkSheetHoverTitle GtkSheetHoverTitle;
  60
  61
  62 struct _GtkSheetCellAttr
  63 {
  64   GtkJustification justification;
  65   GdkColor foreground;
  66   GdkColor background;
  67   GtkSheetCellBorder border;
  68   gboolean is_editable;
  69 };
  70
  71 struct _GtkSheetHoverTitle
  72 {
  73   GtkWidget *window;
  74   GtkWidget *label;
  75   gint row, column;
  76 };
  77
  78 enum
  79   {
  80     BG_COLOR,
  81     GRID_COLOR,
  82     n_COLORS
  83   };
  84
  85 struct _GtkSheet
  86 {
  87   GtkBin parent;
  88
  89   gboolean dispose_has_run;
  90   PsppireAxis *haxis;
  91   PsppireAxis *vaxis;
  92
  93   guint16 flags;
  94
  95   GSheetModel *model;
  96
  97   GtkSelectionMode selection_mode;
  98
  99   /* Component colors */
 100   GdkColor color[n_COLORS];
 101   gboolean show_grid;
 102
 103   gint16 column_requisition;
 104   gint16 row_requisition;
 105
 106   /* active cell */
 107   GtkSheetCell active_cell;
 108
 109   /* The GtkEntry used for editing the cells */
 110   GtkWidget *entry_widget;
 111
 112   /* The type of entry_widget */
 113   GtkType entry_type;
 114
 115   /* Handler of the "changed" callback for the entry widget */
 116   glong entry_handler_id;
 117
 118   /* expanding selection */
 119   GtkSheetCell selection_cell;
 120
 121   /* global selection button */
 122   GtkWidget *button;
 123
 124   /* sheet state */
 125   gint state;
 126
 127   /* selected range */
 128   GtkSheetRange range;
 129
 130   /* the scrolling window and its height and width to
 131    * make things a little speedier */
 132   GdkWindow *sheet_window;
 133
 134   /* border shadow style */
 135   GtkShadowType shadow_type;
 136
 137   /* Column Titles */
 138   GdkRectangle column_title_area;
 139   GdkWindow *column_title_window;
 140   gboolean column_titles_visible;
 141   /* TRUE if the cursor is over the column title window */
 142   gboolean column_title_under;
 143
 144   /* Row Titles */
 145   GdkRectangle row_title_area;
 146   GdkWindow *row_title_window;
 147   gboolean row_titles_visible;
 148   /* TRUE if the cursor is over the row title window */
 149   gboolean row_title_under;
 150
 151   /*scrollbars*/
 152   GtkAdjustment *hadjustment;
 153   GtkAdjustment *vadjustment;
 154
 155   /* xor GC for the verticle drag line */
 156   GdkGC *xor_gc;
 157
 158   /* gc for drawing unselected cells */
 159   GdkGC *fg_gc;
 160   GdkGC *bg_gc;
 161
 162   /* cursor used to indicate dragging */
 163   GdkCursor *cursor_drag;
 164
 165   /* the current x-pixel location of the xor-drag vline */
 166   gint x_drag;
 167
 168   /* the current y-pixel location of the xor-drag hline */
 169   gint y_drag;
 170
 171   /* current cell being dragged */
 172   GtkSheetCell drag_cell;
 173   /* current range being dragged */
 174   GtkSheetRange drag_range;
 175
 176   /* Used for the subtitle (popups) */
 177   gint motion_timer;
 178   GtkSheetHoverTitle *hover_window;
 179 };
 180
 181 struct _GtkSheetClass
 182 {
 183   GtkBinClass parent_class;
 184
 185  void (*set_scroll_adjustments) (GtkSheet *sheet,
 186                                  GtkAdjustment *hadjustment,
 187                                  GtkAdjustment *vadjustment);
 188
 189  void (*select_row)             (GtkSheet *sheet, gint row);
 190
 191  void (*select_column)          (GtkSheet *sheet, gint column);
 192
 193  void (*select_range)           (GtkSheet *sheet, GtkSheetRange *range);
 194
 195  void (*resize_range)           (GtkSheet *sheet,
 196                                 GtkSheetRange *old_range,
 197                                 GtkSheetRange *new_range);
 198
 199  void (*move_range)             (GtkSheet *sheet,
 200                                 GtkSheetRange *old_range,
 201                                 GtkSheetRange *new_range);
 202
 203  gboolean (*traverse)           (GtkSheet *sheet,
 204                                 gint row, gint column,
 205                                 gint *new_row, gint *new_column);
 206
 207  gboolean (*activate)           (GtkSheet *sheet,
 208                                 gint row, gint column);
 209
 210  void (*changed)                (GtkSheet *sheet,
 211                                 gint row, gint column);
 212 };
 213
 214 GType gtk_sheet_get_type (void);
 215 GtkType gtk_sheet_range_get_type (void);
 216
 217
 218 /* create a new sheet */
 219 GtkWidget * gtk_sheet_new (GSheetModel *model);
 220
 221 /* create a new sheet with custom entry */
 222 GtkWidget *
 223 gtk_sheet_new_with_custom_entry (GtkType entry_type);
 224
 225 /* Change entry */
 226 void gtk_sheet_change_entry             (GtkSheet *sheet, GtkType entry_type);
 227
 228 GtkEntry *gtk_sheet_get_entry    (GtkSheet *sheet);
 229
 230
 231 void gtk_sheet_get_selected_range (GtkSheet *sheet,
 232                                          GtkSheetRange *range);
 233
 234 void gtk_sheet_show_grid          (GtkSheet *sheet,
 235                                          gboolean show);
 236
 237 gboolean gtk_sheet_grid_visible   (GtkSheet *sheet);
 238
 239
 240 /* scroll the viewing area of the sheet to the given column
 241  * and row; row_align and col_align are between 0-1 representing the
 242  * location the row should appear on the screen, 0.0 being top or left,
 243  * 1.0 being bottom or right; if row or column is negative then there
 244  * is no change */
 245 void gtk_sheet_moveto (GtkSheet *sheet,
 246                   gint row,
 247                   gint column,
 248                   gfloat row_align,
 249                   gfloat col_align);
 250
 251
 252 void gtk_sheet_show_row_titles          (GtkSheet *sheet);
 253 void gtk_sheet_hide_row_titles          (GtkSheet *sheet);
 254 void gtk_sheet_show_column_titles       (GtkSheet *sheet);
 255 void gtk_sheet_hide_column_titles       (GtkSheet *sheet);
 256
 257 /* select the row. The range is then highlighted, and the bounds are stored
 258  * in sheet->range  */
 259 void gtk_sheet_select_row    (GtkSheet * sheet,  gint row);
 260
 261 /* select the column. The range is then highlighted, and the bounds are stored
 262  * in sheet->range  */
 263 void gtk_sheet_select_column (GtkSheet * sheet,  gint column);
 264
 265 /* highlight the selected range and store bounds in sheet->range */
 266 void gtk_sheet_select_range (GtkSheet *sheet, const GtkSheetRange *range);
 267
 268 void gtk_sheet_get_visible_range (GtkSheet *sheet, GtkSheetRange *range);
 269
 270
 271 /* obvious */
 272 void gtk_sheet_unselect_range           (GtkSheet *sheet);
 273
 274 /* set active cell where the entry will be displayed */
 275 void gtk_sheet_set_active_cell (GtkSheet *sheet,
 276                                 gint row, gint column);
 277
 278 /* Sets *ROW and *COLUMN to be the coordinates of the active cell.
 279    ROW and/or COLUMN may be null if the caller is not interested in their
 280    values */
 281 void gtk_sheet_get_active_cell (GtkSheet *sheet,
 282                                         gint *row, gint *column);
 283
 284 /* get cell contents */
 285 gchar *gtk_sheet_cell_get_text (const GtkSheet *sheet, gint row, gint col);
 286
 287
 288 /* get cell attributes of the given cell */
 289 /* TRUE means that the cell is currently allocated */
 290 gboolean gtk_sheet_get_attributes       (const GtkSheet *sheet,
 291                                         gint row, gint col,
 292                                         GtkSheetCellAttr *attributes);
 293
 294 void gtk_sheet_set_model (GtkSheet *sheet,
 295                                    GSheetModel *model);
 296
 297 GSheetModel * gtk_sheet_get_model (const GtkSheet *sheet);
 298
 299
 300 G_END_DECLS
 301
 302
 303 #endif /* __GTK_SHEET_H__ */
 304
 305