libgtkextra-dev 3.3.3-1 / usr / include / gtkextra-3.0 / gtkextra / gtksheet.h

/* GtkSheet widget for Gtk+.
 * Copyright (C) 1999-2001 Adrian E. Feiguin <adrian@ifir.ifir.edu.ar>
 *
 * Based on GtkClist widget by Jay Painter, but major changes.
 * Memory allocation routines inspired on SC (Spreadsheet Calculator)
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) && !defined (__GTKEXTRA_H_INSIDE__)
#   error "Only <gtkextra/gtkextra.h> can be included directly."
#endif

#ifndef __GTK_SHEET_H__
#define __GTK_SHEET_H__


#ifdef __cplusplus
extern "C"
{
#endif /* __cplusplus */

G_BEGIN_DECLS

typedef enum
{
    GTK_SHEET_FOREGROUND,
    GTK_SHEET_BACKGROUND,
    GTK_SHEET_FONT,
    GTK_SHEET_JUSTIFICATION,
    GTK_SHEET_BORDER,
    GTK_SHEET_BORDER_COLOR,
    GTK_SHEET_IS_EDITABLE,
    GTK_SHEET_IS_VISIBLE
}
GtkSheetAttrType;

/**
 * GtkSheetState:
 * @GTK_SHEET_NORMAL: nothing selected
 * @GTK_SHEET_ROW_SELECTED: one row selected
 * @GTK_SHEET_COLUMN_SELECTED: one column selected
 * @GTK_SHEET_RANGE_SELECTED: rectangular area of cells selected
 *
 * Selection state of the #GtkSheet
 *
 **/
typedef enum
{
    GTK_SHEET_NORMAL,
    GTK_SHEET_ROW_SELECTED,
    GTK_SHEET_COLUMN_SELECTED,
    GTK_SHEET_RANGE_SELECTED
} GtkSheetState;

enum
{
    GTK_SHEET_LEFT_BORDER     = 1 << 0,
    GTK_SHEET_RIGHT_BORDER    = 1 << 1,
    GTK_SHEET_TOP_BORDER      = 1 << 2,
    GTK_SHEET_BOTTOM_BORDER   = 1 << 3
};

/**
 * GtkSheetEntryType:
 * @GTK_SHEET_ENTRY_TYPE_DEFAULT: default, applicat. controlled
 * @GTK_SHEET_ENTRY_TYPE_GTK_ITEM_ENTRY: GtkItemEntry
 * @GTK_SHEET_ENTRY_TYPE_GTK_ENTRY: GtkEntry
 * @GTK_SHEET_ENTRY_TYPE_GTK_TEXT_VIEW: GtkTextView
 * @GTK_SHEET_ENTRY_TYPE_GTK_DATA_TEXT_VIEW: GtkDataTextView
 * @GTK_SHEET_ENTRY_TYPE_GTK_SPIN_BUTTON: GtkSpinButton
 * @GTK_SHEET_ENTRY_TYPE_GTK_COMBO_BOX: GtkComboBox
 * @GTK_SHEET_ENTRY_TYPE_GTK_COMBO_BOX_ENTRY: GtkComboBoxEntry
 * @GTK_SHEET_ENTRY_TYPE_GTK_COMBO: GtkCombo, Deprecated
 *
 * Subset of GtkEditable Widgets to allow selecting a widget 
 * from glade-3 
 *
 **/
typedef enum
{
    GTK_SHEET_ENTRY_TYPE_DEFAULT,
    GTK_SHEET_ENTRY_TYPE_GTK_ITEM_ENTRY,
    GTK_SHEET_ENTRY_TYPE_GTK_ENTRY,
    GTK_SHEET_ENTRY_TYPE_GTK_TEXT_VIEW,
    GTK_SHEET_ENTRY_TYPE_GTK_DATA_TEXT_VIEW,
    GTK_SHEET_ENTRY_TYPE_GTK_SPIN_BUTTON,
    GTK_SHEET_ENTRY_TYPE_GTK_COMBO_BOX,
    GTK_SHEET_ENTRY_TYPE_GTK_COMBO_BOX_ENTRY,
    GTK_SHEET_ENTRY_TYPE_GTK_COMBO,
} GtkSheetEntryType;

/**
 * GtkSheetVerticalJustification:
 * @GTK_SHEET_VERTICAL_JUSTIFICATION_DEFAULT: default 
 * @GTK_SHEET_VERTICAL_JUSTIFICATION_TOP: top aligned
 * @GTK_SHEET_VERTICAL_JUSTIFICATION_MIDDLE: middle aligned
 * @GTK_SHEET_VERTICAL_JUSTIFICATION_BOTTOM: bottom aligned
 *
 * Vertical text alignment. 
 *
 **/
typedef enum
{
    GTK_SHEET_VERTICAL_JUSTIFICATION_DEFAULT,
    GTK_SHEET_VERTICAL_JUSTIFICATION_TOP,
    GTK_SHEET_VERTICAL_JUSTIFICATION_MIDDLE,
    GTK_SHEET_VERTICAL_JUSTIFICATION_BOTTOM,
} GtkSheetVerticalJustification;

/**
 * GtkSheetTraverseType:
 * @GTK_SHEET_TRAVERSE_ALL: default 
 * @GTK_SHEET_TRAVERSE_EDITABLE: only writable cells 
 *
 * Traverse type for cursor movements. 
 *
 **/
typedef enum
{
    GTK_SHEET_TRAVERSE_ALL,
    GTK_SHEET_TRAVERSE_EDITABLE,
} GtkSheetTraverseType;


#define G_TYPE_SHEET \
    (gtk_sheet_get_type ())

#define GTK_SHEET(obj) \
    (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_SHEET, GtkSheet))

#define GTK_IS_SHEET(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_SHEET))

#define GTK_SHEET_CLASS(klass) \
    (G_TYPE_CHECK_CLASS_CAST ((klass), G_TYPE_SHEET, GtkSheetClass))

#define GTK_IS_SHEET_CLASS(klass) \
    (G_TYPE_CHECK_CLASS_TYPE ((klass), G_TYPE_SHEET))

#define GTK_SHEET_GET_CLASS(obj) \
    (G_TYPE_INSTANCE_GET_CLASS ((obj), G_TYPE_SHEET, GtkSheetClass))



#define G_TYPE_SHEET_RANGE \
    (gtk_sheet_range_get_type ())

/* Public flags, for compatibility */

#define GTK_SHEET_IS_LOCKED(sheet)       gtk_sheet_locked(sheet)
#define GTK_SHEET_ROW_FROZEN(sheet)      !gtk_sheet_rows_resizable(sheet)
#define GTK_SHEET_COLUMN_FROZEN(sheet)   !gtk_sheet_columns_resizable(sheet)
#define GTK_SHEET_AUTORESIZE(sheet)      gtk_sheet_autoresize(sheet)
#define GTK_SHEET_CLIP_TEXT(sheet)       gtk_sheet_clip_text(sheet)
#define GTK_SHEET_ROW_TITLES_VISIBLE(sheet)   gtk_sheet_row_titles_visible(sheet)
#define GTK_SHEET_COL_TITLES_VISIBLE(sheet)   gtk_sheet_column_titles_visible(sheet)
#define GTK_SHEET_AUTO_SCROLL(sheet)     gtk_sheet_autoscroll(sheet)
#define GTK_SHEET_JUSTIFY_ENTRY(sheet)   gtk_sheet_justify_entry(sheet)

typedef struct _GtkSheet GtkSheet;
typedef struct _GtkSheetClass GtkSheetClass;
typedef struct _GtkSheetChild GtkSheetChild;
typedef struct _GtkSheetRow GtkSheetRow;
typedef struct _GtkSheetColumn GtkSheetColumn;
typedef struct _GtkSheetColumnClass GtkSheetColumnClass;
typedef struct _GtkSheetCell GtkSheetCell;
typedef struct _GtkSheetRange GtkSheetRange;
typedef struct _GtkSheetButton       GtkSheetButton;
typedef struct _GtkSheetCellAttr     GtkSheetCellAttr;
typedef struct _GtkSheetCellBorder     GtkSheetCellBorder;

#define GTK_SHEET_OPTIMIZE_COLUMN_DRAW  0  /* 0=off, 1=on */


/**
 * GtkSheetChild:
 *
 * The GtkSheetChild struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheetChild
{
    /*< private >*/
    GtkWidget *widget;
    gint x,y;
    gboolean attached_to_cell;
    gboolean floating;
    gint row, col;
    guint16 xpadding;
    guint16 ypadding;
    gboolean xexpand;
    gboolean yexpand;
    gboolean xshrink;
    gboolean yshrink;
    gboolean xfill;
    gboolean yfill;
};


/**
 * GtkSheetButton:
 *
 * The GtkSheetButton struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheetButton
{
    /*< private >*/
    GtkStateType state;
    gchar *label;

    gboolean label_visible;
    GtkSheetChild *child;

    GtkJustification justification;
};


/**
 * GtkSheetCellBorder:
 *
 * The GtkSheetCellBorder struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheetCellBorder
{
    /*< private >*/
    gint8 mask;
    guint width;
    GdkLineStyle line_style;
    GdkCapStyle cap_style;
    GdkJoinStyle join_style;
    GdkColor color;
};

/**
 * GtkSheetCellAttr:
 *
 * The GtkSheetCellAttr struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheetCellAttr
{
    /*< private >*/
    GtkJustification justification;
    GdkFont *font;
    PangoFontDescription *font_desc;
    GdkColor foreground;
    GdkColor background;
    GtkSheetCellBorder border;
    gboolean is_editable;
    gboolean is_visible;
    gboolean is_sensitive;
    gboolean can_focus;
    gboolean do_font_desc_free;   /* TRUE if font_desc needs free */
};

/**
 * GtkSheetCell:
 *
 * The GtkSheetCell struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheetCell
{
    /*< private >*/
    GdkRectangle extent;  /* extent of pango layout + cell attributes.border (used for column auto-resize) */

    gint row;
    gint col;

    GtkSheetCellAttr *attributes;

    gchar *text;
    gpointer link;

    gchar *tooltip_markup; /* tooltip, which is marked up with the Pango text markup language */
    gchar *tooltip_text;  /* tooltip, without markup */
};

/**
 * GtkSheetRange:
 * @row0: upper left cell
 * @col0: upper left cell 
 * @rowi:  lower right cell 
 * @coli: lower right cell 
 *  
 * Defines a rectangular range of cells.
 */
struct _GtkSheetRange
{
    /*< public >*/
    gint row0,col0; /* upper-left cell */
    gint rowi,coli; /* lower-right cell */
};


/**
 * GtkSheetRow:
 *
 * The GtkSheetRow struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheetRow
{
    /*< private >*/
    gchar *name;
    gint height;
    guint16 requisition;
    gint top_ypixel;
    gint max_extent_height;  /* := max(Cell.extent.height) */

    GtkSheetButton button;
    gboolean is_sensitive;
    gboolean is_visible;
    gboolean is_readonly;   /* to override cell editable */
    gboolean can_focus;     /* to allow keyboard/mouse focus */

    gchar *tooltip_markup; /* tooltip, which is marked up with the Pango text markup language */
    gchar *tooltip_text;  /* tooltip, without markup */
};

#include "gtksheetcolumn.h"



/**
 * GtkSheet:
 *
 * The GtkSheet struct contains only private data.
 * It should only be accessed through the functions described below.
 */
struct _GtkSheet
{
    GtkContainer container;    /* parent instance */

    guint16 flags;

    GtkSelectionMode selection_mode;
    gboolean autoresize_columns;
    gboolean autoresize_rows;
    gboolean autoscroll;
    gboolean clip_text;
    gboolean justify_entry;
    gboolean locked;

    guint freeze_count;

    GdkColor bg_color;    /* cell background color */
    GdkColor grid_color;  /* grid color */
    GdkColor tm_color;    /* tooltip marker color */
    gboolean show_grid;

    GList *children;    /* sheet children */

    /* allocation rectangle after the container_border_width
       and the width of the shadow border */
    GdkRectangle internal_allocation;

    gchar *title;
    gchar *description;         /* sheet description and further information for application use */

    GtkSheetRow *row;
    GtkSheetColumn **column;  /* flexible array of column pointers */

    gboolean rows_resizable;
    gboolean columns_resizable;

    /* max number of diplayed cells */
    gint maxrow;
    gint maxcol;

    /* Displayed range */

    GtkSheetRange view;

    /* sheet data: dynamically allocated array of cell pointers */
    GtkSheetCell ***data;

    /* max number of allocated cells in **data */
    gint maxallocrow;
    gint maxalloccol;

    /* active cell */
    GtkSheetCell active_cell;
    GtkWidget *sheet_entry;

    GType entry_type;  /* wanted entry type */
    GType installed_entry_type;  /* installed entry type */

    /* expanding selection */
    GtkSheetCell selection_cell;

    /* timer for automatic scroll during selection */
    gint32 timer;
    /* timer for flashing clipped range */
    gint32 clip_timer;
    gint interval;

    /* global selection button */
    GtkWidget *button;

    /* sheet state */
    GtkSheetState state;

    /* selected range */
    GtkSheetRange range;

    /*the scrolling window and it's height and width to
     * make things a little speedier */
    GdkWindow *sheet_window;
    guint sheet_window_width;
    guint sheet_window_height;

    /* sheet backing pixmap */
    GdkWindow *pixmap;

    /* offsets for scrolling */
    gint hoffset;
    gint voffset;
    gfloat old_hadjustment;
    gfloat old_vadjustment;

    /* border shadow style */
    GtkShadowType shadow_type;

    GtkSheetVerticalJustification vjust;   /* default vertical text justification */

    /* traverse type for gtksheet movement */
    GtkSheetTraverseType traverse_type;

    /* Column Titles */
    GdkRectangle column_title_area;
    GdkWindow *column_title_window;
    gboolean column_titles_visible;

    /* Row Titles */
    GdkRectangle row_title_area;
    GdkWindow *row_title_window;
    gboolean row_titles_visible;

    /*scrollbars*/
    GtkAdjustment *hadjustment;
    GtkAdjustment *vadjustment;

    /* xor GC for the verticle drag line */
    GdkGC *xor_gc;

    /* gc for drawing unselected cells */
    GdkGC *fg_gc;
    GdkGC *bg_gc;

    /* cursor used to indicate dragging */
    GdkCursor *cursor_drag;

    /* the current x-pixel location of the xor-drag vline */
    gint x_drag;

    /* the current y-pixel location of the xor-drag hline */
    gint y_drag;

    /* current cell being dragged */
    GtkSheetCell drag_cell;
    /* current range being dragged */
    GtkSheetRange drag_range;

    /* clipped range */
    GtkSheetRange clip_range;
};

struct _GtkSheetClass
{
    GtkContainerClass parent_class;

    void (*set_scroll_adjustments)(GtkSheet *sheet,
                                   GtkAdjustment *hadjustment, GtkAdjustment *vadjustment);

    void (*select_row)(GtkSheet *sheet, gint row);
    void (*select_column)(GtkSheet *sheet, gint column);
    void (*select_range)(GtkSheet *sheet, GtkSheetRange *range);
    void (*clip_range)(GtkSheet *sheet, GtkSheetRange *clip_range);

    void (*resize_range)(GtkSheet *sheet,
                         GtkSheetRange *old_range, GtkSheetRange *new_range);

    void (*move_range)(GtkSheet *sheet,
                       GtkSheetRange *old_range, GtkSheetRange *new_range);

    gboolean(*traverse)(GtkSheet *sheet,
                        gint row, gint column, gint *new_row, gint *new_column);

    gboolean(*deactivate)(GtkSheet *sheet, gint row, gint column);
    gboolean(*activate)(GtkSheet *sheet, gint row, gint column);

    void (*set_cell)(GtkSheet *sheet, gint row, gint column);
    void (*clear_cell)(GtkSheet *sheet, gint row, gint column);
    void (*changed)(GtkSheet *sheet, gint row, gint column);
    void (*new_column_width)(GtkSheet *sheet, gint col, guint width);
    void (*new_row_height)(GtkSheet *sheet, gint row, guint height);

    gboolean(*focus_in_event)(GtkSheet *sheet, GdkEventFocus *event);
    gboolean(*focus_out_event)(GtkSheet *sheet, GdkEventFocus *event);

    void (*move_cursor)(GtkSheet *sheet,
                        GtkMovementStep step,
                        gint count,
                        gboolean extend_selection);
};

GType gtk_sheet_get_type(void);
GType gtk_sheet_range_get_type(void);

/* create a new sheet */
GtkWidget *gtk_sheet_new(guint rows, guint columns, const gchar *title);
void gtk_sheet_construct(GtkSheet *sheet, guint rows, guint columns, const gchar *title);

/* create a new browser sheet. It cells can not be edited */
GtkWidget *gtk_sheet_new_browser(guint rows, guint columns, const gchar *title);
void gtk_sheet_construct_browser(GtkSheet *sheet, guint rows, guint columns, const gchar *title);

/* create a new sheet with custom entry */
GtkWidget *gtk_sheet_new_with_custom_entry(guint rows, guint columns,
                                           const gchar *title, GType entry_type);
void gtk_sheet_construct_with_custom_entry(GtkSheet *sheet,
                                           guint rows, guint columns, const gchar *title, GType entry_type);

/* change scroll adjustments */
void gtk_sheet_set_hadjustment(GtkSheet *sheet, GtkAdjustment *adjustment);
void gtk_sheet_set_vadjustment(GtkSheet *sheet, GtkAdjustment *adjustment);

/* sheet entry */
void gtk_sheet_change_entry(GtkSheet *sheet, const GType entry_type);

GType gtk_sheet_get_entry_type(GtkSheet *sheet);
GtkWidget *gtk_sheet_get_entry(GtkSheet *sheet);
GtkWidget *gtk_sheet_get_entry_widget(GtkSheet *sheet);

gchar *gtk_sheet_get_entry_text(GtkSheet *sheet);
void gtk_sheet_set_entry_text(GtkSheet *sheet, const gchar *text);
void gtk_sheet_set_entry_editable(GtkSheet *sheet, const gboolean editable);
void gtk_sheet_entry_select_region(GtkSheet *sheet, gint start_pos, gint end_pos);

gulong gtk_sheet_entry_signal_connect_changed(GtkSheet *sheet, GCallback handler);
void gtk_sheet_entry_signal_disconnect_by_func(GtkSheet *sheet, GCallback handler);

/* Added by Steven Rostedt <steven.rostedt@lmco.com> */
GtkSheetState gtk_sheet_get_state(GtkSheet *sheet);

guint gtk_sheet_get_rows_count(GtkSheet *sheet);
guint gtk_sheet_get_columns_count(GtkSheet *sheet);

/* sheet's ranges - Added by Murray Cumming */
void gtk_sheet_get_visible_range(GtkSheet *sheet, GtkSheetRange *range);
gboolean gtk_sheet_get_selection(GtkSheet *sheet, GtkSheetState *state, GtkSheetRange *range);
void gtk_sheet_set_selection_mode(GtkSheet *sheet, GtkSelectionMode mode);
void gtk_sheet_set_autoresize(GtkSheet *sheet, gboolean autoresize);
void gtk_sheet_set_autoresize_columns(GtkSheet *sheet, gboolean autoresize);
void gtk_sheet_set_autoresize_rows(GtkSheet *sheet, gboolean autoresize);
gboolean gtk_sheet_autoresize(GtkSheet *sheet);
gboolean gtk_sheet_autoresize_columns(GtkSheet *sheet);
gboolean gtk_sheet_autoresize_rows(GtkSheet *sheet);

void gtk_sheet_set_autoscroll(GtkSheet *sheet, gboolean autoscroll);
gboolean gtk_sheet_autoscroll(GtkSheet *sheet);
void gtk_sheet_set_clip_text(GtkSheet *sheet, gboolean clip_text);
gboolean gtk_sheet_clip_text(GtkSheet *sheet);
void gtk_sheet_set_justify_entry(GtkSheet *sheet, gboolean justify);
gboolean gtk_sheet_justify_entry(GtkSheet *sheet);
void gtk_sheet_set_vjustification(GtkSheet *sheet, GtkSheetVerticalJustification vjust);
GtkSheetVerticalJustification gtk_sheet_get_vjustification(GtkSheet *sheet);
void gtk_sheet_set_traverse_type(GtkSheet *sheet, GtkSheetTraverseType ttype);
GtkSheetTraverseType gtk_sheet_get_traverse_type(GtkSheet *sheet);
void gtk_sheet_set_locked(GtkSheet *sheet, gboolean locked);
gboolean gtk_sheet_locked(GtkSheet *sheet);

/* set sheet title */
void gtk_sheet_set_title(GtkSheet *sheet, const gchar *title);
void gtk_sheet_set_description(GtkSheet *sheet, const gchar *description);
const gchar *gtk_sheet_get_description(GtkSheet *sheet, const gchar *description);

/* freeze all visual updates of the sheet.
 * Then thaw the sheet after you have made a number of changes.
 * The updates will occure in a more efficent way than if you made 
 * them on a unfrozen sheet 
 */
gboolean gtk_sheet_is_frozen(GtkSheet *sheet);
void gtk_sheet_freeze(GtkSheet *sheet);
void gtk_sheet_thaw(GtkSheet *sheet);

/* Background colors */
void gtk_sheet_set_background(GtkSheet *sheet, GdkColor *color);
void gtk_sheet_set_grid(GtkSheet *sheet, GdkColor *color);
void gtk_sheet_show_grid(GtkSheet *sheet, gboolean show);
gboolean gtk_sheet_grid_visible(GtkSheet *sheet);


/* set/get row title */
void gtk_sheet_set_row_title(GtkSheet *sheet, gint row, const gchar *title);
const gchar *gtk_sheet_get_row_title(GtkSheet *sheet, gint row);

/* set/get button label */
void gtk_sheet_row_button_add_label(GtkSheet *sheet,  gint row, const gchar *label);
const gchar *gtk_sheet_row_button_get_label(GtkSheet *sheet,  gint row);
void gtk_sheet_row_button_justify(GtkSheet *sheet, gint row, GtkJustification justification);

/* scroll the viewing area of the sheet to the given column
 * and row; row_align and col_align are between 0-1 representing the
 * location the row should appear on the screnn, 0.0 being top or left,
 * 1.0 being bottom or right; if row or column is negative then there
 * is no change */
void gtk_sheet_moveto(GtkSheet *sheet, gint row, gint column, gint row_align, gint col_align);

/* resize column/row titles window */
void gtk_sheet_set_row_titles_width(GtkSheet *sheet, guint width);

/* show/hide column/row titles window */
void gtk_sheet_show_row_titles(GtkSheet *sheet);
void gtk_sheet_hide_row_titles(GtkSheet *sheet);
gboolean gtk_sheet_row_titles_visible(GtkSheet *sheet);

/* row button sensitivity */

gboolean gtk_sheet_row_sensitive(GtkSheet *sheet, gint row);
void gtk_sheet_row_set_sensitivity(GtkSheet *sheet, gint row,  gboolean sensitive);
void gtk_sheet_rows_set_sensitivity(GtkSheet *sheet, gboolean sensitive);

/* row resizeability */

gboolean gtk_sheet_rows_resizable(GtkSheet *sheet);
void gtk_sheet_rows_set_resizable(GtkSheet *sheet, gboolean resizable);


/* row visibility */
gboolean gtk_sheet_row_visible(GtkSheet *sheet, gint row);
void gtk_sheet_row_set_visibility(GtkSheet *sheet, gint row, gboolean visible);

void gtk_sheet_row_label_set_visibility(GtkSheet *sheet, gint row, gboolean visible);
void gtk_sheet_rows_labels_set_visibility(GtkSheet *sheet, gboolean visible);


/* sheet tooltips */
gchar *gtk_sheet_get_tooltip_markup(GtkSheet *sheet);
void gtk_sheet_set_tooltip_markup(GtkSheet *sheet, const gchar *markup);
gchar *gtk_sheet_get_tooltip_text(GtkSheet *sheet);
void gtk_sheet_set_tooltip_text(GtkSheet *sheet, const gchar *text);

/* row tooltips */
gchar *gtk_sheet_row_get_tooltip_markup(GtkSheet *sheet, const gint row);
void gtk_sheet_row_set_tooltip_markup(GtkSheet *sheet, const gint row, const gchar *markup);
gchar *gtk_sheet_row_get_tooltip_text(GtkSheet *sheet, const gint row);
void gtk_sheet_row_set_tooltip_text(GtkSheet *sheet, const gint row, const gchar *text);

/* row readonly */
gboolean gtk_sheet_row_get_readonly(GtkSheet *sheet, const gint row);
void gtk_sheet_row_set_readonly(GtkSheet *sheet, const gint row, const gboolean is_readonly);

/* row focus flag */
gboolean gtk_sheet_row_get_can_focus(GtkSheet *sheet, const gint row);
void gtk_sheet_row_set_can_focus(GtkSheet *sheet, const gint row, const gboolean can_focus);

/* cell tooltips */
gchar *gtk_sheet_cell_get_tooltip_markup(GtkSheet *sheet, const gint row, const gint col);
void gtk_sheet_cell_set_tooltip_markup(GtkSheet *sheet,
                                       const gint row, const gint col, const gchar *markup);
gchar *gtk_sheet_cell_get_tooltip_text(GtkSheet *sheet, const gint row, const gint col);
void gtk_sheet_cell_set_tooltip_text(GtkSheet *sheet,
                                     const gint row, const gint col, const gchar *text);

/* cell editable */
gboolean gtk_sheet_cell_get_editable(GtkSheet *sheet, const gint row, const gint col);
void gtk_sheet_cell_set_editable(GtkSheet *sheet, const gint row, const gint col, const gboolean is_editable);

/* cell sensitive */
gboolean gtk_sheet_cell_get_sensitive(GtkSheet *sheet, const gint row, const gint col);
void gtk_sheet_cell_set_sensitive(GtkSheet *sheet, const gint row, const gint col, const gboolean is_sensitive);

/* cell can_focus */
gboolean gtk_sheet_cell_get_can_focus(GtkSheet *sheet, const gint row, const gint col);
void gtk_sheet_cell_set_can_focus(GtkSheet *sheet, const gint row, const gint col, const gboolean can_focus);

/* selection range. The range gets highlighted, and its bounds are stored in sheet->range  */
void gtk_sheet_select_row(GtkSheet *sheet, gint row);
void gtk_sheet_select_column(GtkSheet *sheet, gint column);
void gtk_sheet_select_range(GtkSheet *sheet, const GtkSheetRange *range);

/* clipboard */
void gtk_sheet_clip_range(GtkSheet *sheet, const GtkSheetRange *clip_range);
void gtk_sheet_unclip_range(GtkSheet *sheet);
gboolean gtk_sheet_in_clip(GtkSheet *sheet);

/* get scrollbars adjustment */
GtkAdjustment *gtk_sheet_get_vadjustment(GtkSheet *sheet);
GtkAdjustment *gtk_sheet_get_hadjustment(GtkSheet *sheet);

/* obvious */
void gtk_sheet_unselect_range(GtkSheet *sheet);

/* set active cell where the entry will be displayed 
 * returns FALSE if current cell can't be deactivated or
 * requested cell can't be activated */
gboolean gtk_sheet_set_active_cell(GtkSheet *sheet, gint row, gint column);
void gtk_sheet_get_active_cell(GtkSheet *sheet, gint *row, gint *column);

/* movement */
void gtk_sheet_set_tab_direction(GtkSheet *sheet, GtkDirectionType dir);

/* set cell contents and allocate memory if needed */
void gtk_sheet_set_cell(GtkSheet *sheet, gint row, gint col,
                        GtkJustification justification, const gchar *text);
void gtk_sheet_set_cell_text(GtkSheet *sheet, gint row, gint col, const gchar *text);

/* get cell contents */
gchar *gtk_sheet_cell_get_text(GtkSheet *sheet, gint row, gint col);

/* clear cell contents */
void gtk_sheet_cell_clear(GtkSheet *sheet, gint row, gint column);

/* clear cell contents and remove links */
void gtk_sheet_cell_delete(GtkSheet *sheet, gint row, gint column);

/* clear range contents. If range==NULL the whole sheet will be cleared */
void gtk_sheet_range_clear(GtkSheet *sheet, const GtkSheetRange *range);

/* clear range contents and remove links */
void gtk_sheet_range_delete(GtkSheet *sheet, const GtkSheetRange *range);

/* get cell state: GTK_STATE_NORMAL, GTK_STATE_SELECTED */
GtkStateType gtk_sheet_cell_get_state(GtkSheet *sheet, gint row, gint col);

/* Handles cell links */
void gtk_sheet_link_cell(GtkSheet *sheet, gint row, gint col, gpointer link);
gpointer gtk_sheet_get_link(GtkSheet *sheet, gint row, gint col);
void gtk_sheet_remove_link(GtkSheet *sheet, gint row, gint col);

/* get row and column correspondig to the given position in the screen */
gboolean gtk_sheet_get_pixel_info(GtkSheet *sheet,
    GdkWindow *window, gint x, gint y, gint *row, gint *column);

/* get area of a given cell */
gboolean gtk_sheet_get_cell_area(GtkSheet *sheet,
                                 gint row, gint column, GdkRectangle *area);

/* set row height */
void gtk_sheet_set_row_height(GtkSheet *sheet, gint row, guint height);

/* append ncols columns to the end of the sheet */
void gtk_sheet_add_column(GtkSheet *sheet, guint ncols);

/* append nrows row to the end of the sheet */
void gtk_sheet_add_row(GtkSheet *sheet, guint nrows);

/* insert nrows rows before the given row and pull right */
void gtk_sheet_insert_rows(GtkSheet *sheet, guint row, guint nrows);

/* insert ncols columns before the given col and pull down */
void gtk_sheet_insert_columns(GtkSheet *sheet, guint col, guint ncols);

/* delete nrows rows starting in row */
void gtk_sheet_delete_rows(GtkSheet *sheet, guint row, guint nrows);

/* delete ncols columns starting in col */
void gtk_sheet_delete_columns(GtkSheet *sheet, guint col, guint ncols);

/* set abckground color of the given range */
void gtk_sheet_range_set_background(GtkSheet *sheet,
                                    const GtkSheetRange *urange, const GdkColor *color);

/* set foreground color (text color) of the given range */
void gtk_sheet_range_set_foreground(GtkSheet *sheet,
                                    const GtkSheetRange *urange, const GdkColor *color);

/* set text justification (GTK_JUSTIFY_LEFT, RIGHT, CENTER) of the given range.
 * The default value is GTK_JUSTIFY_LEFT. If autoformat is on, the
 * default justification for numbers is GTK_JUSTIFY_RIGHT */
void gtk_sheet_range_set_justification(GtkSheet *sheet,
                                       const GtkSheetRange *urange, GtkJustification just);

/* set if cell contents can be edited or not in the given range:
 * accepted values are TRUE or FALSE. */
void gtk_sheet_range_set_editable(GtkSheet *sheet,
                                  const GtkSheetRange *urange, gint editable);

/* set if cell contents are visible or not in the given range:
 * accepted values are TRUE or FALSE.*/
void gtk_sheet_range_set_visible(GtkSheet *sheet,
                                 const GtkSheetRange *urange, gboolean visible);

/* set cell border style in the given range.
 * mask values are CELL_LEFT_BORDER, CELL_RIGHT_BORDER, CELL_TOP_BORDER,
 * CELL_BOTTOM_BORDER
 * width is the width of the border line in pixels 
 * line_style is the line_style for the border line */
void gtk_sheet_range_set_border(GtkSheet *sheet,
                                const GtkSheetRange *urange, gint mask, guint width, gint line_style);

/* set border color for the given range */
void gtk_sheet_range_set_border_color(GtkSheet *sheet,
                                      const GtkSheetRange *urange, const GdkColor *color);

/* set font for the given range */
void gtk_sheet_range_set_font(GtkSheet *sheet,
                              const GtkSheetRange *urange, PangoFontDescription *font_desc);

/* get cell attributes of the given cell */
/* TRUE means that the cell is currently allocated */
gboolean gtk_sheet_get_attributes(GtkSheet *sheet, gint row, gint col, GtkSheetCellAttr *attributes);


GtkSheetChild *gtk_sheet_put(GtkSheet *sheet, GtkWidget *child, gint x, gint y);
void gtk_sheet_attach_floating(GtkSheet *sheet, GtkWidget *widget, gint row, gint col);
void gtk_sheet_attach_default(GtkSheet *sheet, GtkWidget *widget, gint row, gint col);
void gtk_sheet_attach(GtkSheet *sheet, GtkWidget *widget,
                      gint row, gint col, gint xoptions, gint yoptions, gint xpadding, gint ypadding);
void gtk_sheet_move_child(GtkSheet *sheet, GtkWidget *widget, gint x, gint y);
const GtkSheetChild *gtk_sheet_get_child_at(GtkSheet *sheet, gint row, gint col);
void gtk_sheet_button_attach(GtkSheet *sheet, GtkWidget *widget, gint row, gint col);

gint gtk_sheet_width( GtkSheet *sheet );
gint gtk_sheet_height( GtkSheet *sheet );

/*< private >*/

void _gtk_sheet_range_fixup(GtkSheet *sheet, GtkSheetRange *range);

void _gtk_sheet_entry_size_allocate(GtkSheet *sheet);
void _gtk_sheet_button_size_request(GtkSheet *sheet,
                                    GtkSheetButton *button, GtkRequisition *requisition);
void _gtk_sheet_scrollbar_adjust(GtkSheet *sheet);

void _gtk_sheet_recalc_top_ypixels(GtkSheet *sheet);
void _gtk_sheet_recalc_left_xpixels(GtkSheet *sheet);
void _gtk_sheet_recalc_view_range(GtkSheet *sheet);

void _gtk_sheet_reset_text_column(GtkSheet *sheet, gint start_column);

void _gtk_sheet_range_draw(GtkSheet *sheet,
                           const GtkSheetRange *range, gboolean activate_active_cell);
void _gtk_sheet_hide_active_cell(GtkSheet *sheet);
void _gtk_sheet_redraw_internal(GtkSheet *sheet,
                                gboolean reset_hadjustment, gboolean reset_vadjustment);

void _gtk_sheet_draw_button(GtkSheet *sheet, gint row, gint col);

GtkSheetEntryType _gtk_sheet_entry_type_from_gtype(GType entry_type);
GType _gtk_sheet_entry_type_to_gtype(GtkSheetEntryType ety);

guint _gtk_sheet_row_default_height(GtkWidget *widget);

void _gtk_sheet_child_hide(GtkSheetChild *child);
void _gtk_sheet_child_show(GtkSheetChild *child);

G_END_DECLS

#ifdef __cplusplus
}
#endif /* __cplusplus */


#endif /* __GTK_SHEET_H__ */