X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=lib%2Fgtksheet%2Fgtksheet.h;h=e039874c521a5a202d228bbaa1717cc25a5b5370;hb=f82fc1927db3d6a1bd1b83089e53678203b36d1b;hp=d8db6c40e39098ff2dd5138e45aae06ae5588138;hpb=655bf3a3917cdf16f99fcbb680d2bf3159126a93;p=pspp-builds.git diff --git a/lib/gtksheet/gtksheet.h b/lib/gtksheet/gtksheet.h index d8db6c40..e039874c 100644 --- a/lib/gtksheet/gtksheet.h +++ b/lib/gtksheet/gtksheet.h @@ -1,4 +1,4 @@ -/* This version of GtkSheet has been heavily modified, for the specific +/* This version of GtkSheet has been heavily modified, for the specific requirements of PSPPIRE. */ @@ -34,33 +34,17 @@ #include "gsheet-row-iface.h" -#ifdef __cplusplus -extern "C" { -#endif /* __cplusplus */ - - -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; +G_BEGIN_DECLS /* sheet->state */ - -enum +enum { GTK_SHEET_NORMAL, GTK_SHEET_ROW_SELECTED, GTK_SHEET_COLUMN_SELECTED, GTK_SHEET_RANGE_SELECTED }; - + #define GTK_TYPE_SHEET_RANGE (gtk_sheet_range_get_type ()) #define GTK_TYPE_SHEET (gtk_sheet_get_type ()) @@ -69,21 +53,11 @@ enum #define GTK_SHEET_CLASS(klass) GTK_CHECK_CLASS_CAST (klass, gtk_sheet_get_type (), GtkSheetClass) #define GTK_IS_SHEET(obj) GTK_CHECK_TYPE (obj, gtk_sheet_get_type ()) -/* Public flags, for compatibility */ - -#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 _GtkSheetClass GtkSheetClass; typedef struct _GtkSheetCellAttr GtkSheetCellAttr; typedef struct _GtkSheetCell GtkSheetCell; +typedef struct _GtkSheetHoverTitle GtkSheetHoverTitle; struct _GtkSheetCellAttr @@ -104,9 +78,25 @@ struct _GtkSheetCell }; -struct _GtkSheet{ - GtkContainer container; +struct _GtkSheetHoverTitle +{ + GtkWidget *window; + GtkWidget *label; + gint row, column; +}; +enum + { + BG_COLOR, + GRID_COLOR, + n_COLORS + }; + +struct _GtkSheet +{ + GtkBin parent; + + gboolean dispose_has_run; GSheetColumn *column_geometry; GSheetRow *row_geometry; @@ -115,51 +105,37 @@ struct _GtkSheet{ GSheetModel *model; GtkSelectionMode selection_mode; - gboolean autoresize; - gboolean autoscroll; - gboolean clip_text; - gboolean justify_entry; - - guint freeze_count; - /* Background colors */ - GdkColor bg_color; - GdkColor grid_color; + /* Component colors */ + GdkColor color[n_COLORS]; gboolean show_grid; - /* sheet children */ - GList *children; - /* allocation rectangle after the container_border_width and the width of the shadow border */ GdkRectangle internal_allocation; - gchar *name; - gint16 column_requisition; gint16 row_requisition; gboolean rows_resizable; gboolean columns_resizable; - /* Displayed range */ - GtkSheetRange view; - /* active cell */ GtkSheetCell active_cell; - GtkWidget *sheet_entry; + /* The GtkEntry used for editing the cells */ + GtkWidget *entry_widget; + + /* The widget containing entry_widget, or + entry_widget itself if no container */ + GtkWidget *entry_container; + + /* The type of entry_widget */ GtkType 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; @@ -169,33 +145,26 @@ struct _GtkSheet{ /* selected range */ GtkSheetRange range; - /*the scrolling window and it's height and width to + /* the scrolling window and its height and width to * make things a little speedier */ GdkWindow *sheet_window; - guint sheet_window_width; - guint sheet_window_height; - - /* sheet backing pixmap */ - GdkPixmap *pixmap; - - /* offsets for scrolling */ - gint hoffset; - gint voffset; - gfloat old_hadjustment; - gfloat old_vadjustment; - + /* border shadow style */ GtkShadowType shadow_type; - + /* Column Titles */ GdkRectangle column_title_area; GdkWindow *column_title_window; gboolean column_titles_visible; + /* TRUE if the cursor is over the column title window */ + gboolean column_title_under; /* Row Titles */ GdkRectangle row_title_area; GdkWindow *row_title_window; gboolean row_titles_visible; + /* TRUE if the cursor is over the row title window */ + gboolean row_title_under; /*scrollbars*/ GtkAdjustment *hadjustment; @@ -222,14 +191,15 @@ struct _GtkSheet{ /* current range being dragged */ GtkSheetRange drag_range; - /* clipped range */ - GtkSheetRange clip_range; + /* Used for the subtitle (popups) */ + gint motion_timer; + GtkSheetHoverTitle *hover_window; }; struct _GtkSheetClass { - GtkContainerClass parent_class; - + GtkBinClass parent_class; + void (*set_scroll_adjustments) (GtkSheet *sheet, GtkAdjustment *hadjustment, GtkAdjustment *vadjustment); @@ -240,8 +210,6 @@ struct _GtkSheetClass 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); @@ -254,463 +222,107 @@ struct _GtkSheetClass 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); - }; - + GType gtk_sheet_get_type (void); GtkType gtk_sheet_range_get_type (void); /* create a new sheet */ GtkWidget * gtk_sheet_new (GSheetRow *vgeo, GSheetColumn *hgeo, - const gchar *title, GSheetModel *model); - - - -/* 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 (GSheetRow *vgeo, GSheetColumn *hgeo, - const gchar *title, GtkType entry_type); void gtk_sheet_construct_with_custom_entry (GtkSheet *sheet, GSheetRow *vgeo, GSheetColumn *hgeo, - const gchar *title, GtkType entry_type); -/* change scroll adjustments */ -void -gtk_sheet_set_hadjustment (GtkSheet *sheet, - GtkAdjustment *adjustment); -void -gtk_sheet_set_vadjustment (GtkSheet *sheet, - GtkAdjustment *adjustment); /* Change entry */ -void -gtk_sheet_change_entry (GtkSheet *sheet, GtkType entry_type); - -/* Returns sheet's entry widget */ -GtkWidget * -gtk_sheet_get_entry (GtkSheet *sheet); -GtkWidget * -gtk_sheet_get_entry_widget (GtkSheet *sheet); +void gtk_sheet_change_entry (GtkSheet *sheet, GtkType entry_type); -/* Returns sheet->state - * Added by Steven Rostedt */ -gint -gtk_sheet_get_state (GtkSheet *sheet); +GtkWidget *gtk_sheet_get_entry (GtkSheet *sheet); -/* Returns sheet's ranges - * Added by Murray Cumming */ -guint -gtk_sheet_get_columns_count (GtkSheet *sheet); -guint -gtk_sheet_get_rows_count (GtkSheet *sheet); - -void -gtk_sheet_get_visible_range (GtkSheet *sheet, +void gtk_sheet_get_selected_range (GtkSheet *sheet, GtkSheetRange *range); -void -gtk_sheet_set_selection_mode (GtkSheet *sheet, gint mode); - -void -gtk_sheet_set_autoresize (GtkSheet *sheet, gboolean autoresize); - -gboolean -gtk_sheet_autoresize (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_locked (GtkSheet *sheet, gboolean lock); - -gboolean -gtk_sheet_locked (const GtkSheet *sheet); - -/* set sheet title */ -void -gtk_sheet_set_title (GtkSheet *sheet, const gchar *title); - -/* 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 */ -void -gtk_sheet_freeze (GtkSheet *sheet); -void -gtk_sheet_thaw (GtkSheet *sheet); -/* Background colors */ -void -gtk_sheet_set_background (GtkSheet *sheet, - GdkColor *bg_color); -void -gtk_sheet_set_grid (GtkSheet *sheet, - GdkColor *grid_color); -void -gtk_sheet_show_grid (GtkSheet *sheet, +void gtk_sheet_show_grid (GtkSheet *sheet, gboolean show); -gboolean -gtk_sheet_grid_visible (GtkSheet *sheet); - -/* set/get column title */ -void -gtk_sheet_set_column_title (GtkSheet * sheet, - gint column, - const gchar * title); - -const gchar * -gtk_sheet_get_column_title (GtkSheet * sheet, - gint column); - -/* 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); +gboolean gtk_sheet_grid_visible (GtkSheet *sheet); /* 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, + * location the row should appear on the screen, 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, +void gtk_sheet_moveto (GtkSheet *sheet, gint row, gint column, gfloat row_align, gfloat col_align); -void -gtk_sheet_show_row_titles (GtkSheet *sheet); -void -gtk_sheet_hide_row_titles (GtkSheet *sheet); -gboolean -gtk_sheet_row_titles_visible (GtkSheet *sheet); - - -/* set row button sensitivity. If sensitivity is TRUE can be toggled, - * otherwise it acts as a title */ -void -gtk_sheet_row_set_sensitivity (GtkSheet *sheet, - gint row, gboolean sensitive); - -/* set sensitivity for all row buttons */ -void -gtk_sheet_rows_set_sensitivity (GtkSheet *sheet, gboolean sensitive); -void -gtk_sheet_rows_set_resizable (GtkSheet *sheet, gboolean resizable); -gboolean -gtk_sheet_rows_resizable (GtkSheet *sheet); - -/* set row visibility. The default value is TRUE. If FALSE, the - * row is hidden */ -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); - +void gtk_sheet_show_row_titles (GtkSheet *sheet); +void gtk_sheet_hide_row_titles (GtkSheet *sheet); +void gtk_sheet_show_column_titles (GtkSheet *sheet); +void gtk_sheet_hide_column_titles (GtkSheet *sheet); /* select the row. The range is then highlighted, and the bounds are stored * in sheet->range */ -void -gtk_sheet_select_row (GtkSheet * sheet, - gint row); +void gtk_sheet_select_row (GtkSheet * sheet, gint row); /* select the column. The range is then highlighted, and the bounds are stored * in sheet->range */ -void -gtk_sheet_select_column (GtkSheet * sheet, - gint column); - -/* save selected range to "clipboard" */ -void -gtk_sheet_clip_range (GtkSheet *sheet, const GtkSheetRange *range); -/* free clipboard */ -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); +void gtk_sheet_select_column (GtkSheet * sheet, gint column); /* highlight the selected range and store bounds in sheet->range */ -void gtk_sheet_select_range (GtkSheet *sheet, - const GtkSheetRange *range); - -/* 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); - -/* 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 (const GtkSheet *sheet, gint row, gint col); - -/* clear cell contents */ -void -gtk_sheet_cell_clear (GtkSheet *sheet, gint row, gint col); -/* clear cell contents and remove links */ -void -gtk_sheet_cell_delete (GtkSheet *sheet, gint row, gint col); - -/* 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); - -/* get row and column correspondig to the given position in the screen */ -gboolean -gtk_sheet_get_pixel_info (GtkSheet * sheet, - 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); +void gtk_sheet_select_range (GtkSheet *sheet, const GtkSheetRange *range); +void gtk_sheet_get_visible_range (GtkSheet *sheet, GtkSheetRange *range); -/* delete nrows rows starting in row */ -void -gtk_sheet_delete_rows (GtkSheet *sheet, guint row, guint nrows); -/* 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); - -/* set abckground color of the given range */ -void -gtk_sheet_range_set_background (GtkSheet *sheet, - const GtkSheetRange *range, - const GdkColor *color); - -/* set foreground color (text color) of the given range */ -void -gtk_sheet_range_set_foreground (GtkSheet *sheet, - const GtkSheetRange *range, - const GdkColor *color); +/* obvious */ +void gtk_sheet_unselect_range (GtkSheet *sheet); -/* 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 *range, - GtkJustification justification); -void -gtk_sheet_column_set_justification (GtkSheet *sheet, - gint column, - GtkJustification justification); -/* 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 *range, - gint editable); +/* set active cell where the entry will be displayed */ +void gtk_sheet_set_active_cell (GtkSheet *sheet, + gint row, gint column); -/* 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 *range, - 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 *range, - gint mask, - guint width, - gint line_style); +/* Sets *ROW and *COLUMN to be the coordinates of the active cell. + ROW and/or COLUMN may be null if the caller is not interested in their + values */ +void gtk_sheet_get_active_cell (GtkSheet *sheet, + gint *row, gint *column); -/* set border color for the given range */ -void -gtk_sheet_range_set_border_color (GtkSheet *sheet, - const GtkSheetRange *range, - const GdkColor *color); +/* get cell contents */ +gchar *gtk_sheet_cell_get_text (const GtkSheet *sheet, gint row, gint col); -/* set font for the given range */ -void -gtk_sheet_range_set_font (GtkSheet *sheet, - const GtkSheetRange *range, - PangoFontDescription *font); /* get cell attributes of the given cell */ /* TRUE means that the cell is currently allocated */ -gboolean -gtk_sheet_get_attributes (const GtkSheet *sheet, - gint row, gint col, +gboolean gtk_sheet_get_attributes (const GtkSheet *sheet, + gint row, gint col, GtkSheetCellAttr *attributes); - -GtkSheetChild * -gtk_sheet_put (GtkSheet *sheet, - GtkWidget *widget, - 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); - -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); - - - -void gtk_sheet_set_model(GtkSheet *sheet, +void gtk_sheet_set_model (GtkSheet *sheet, GSheetModel *model); -GSheetModel * gtk_sheet_get_model(const GtkSheet *sheet); +GSheetModel * gtk_sheet_get_model (const GtkSheet *sheet); -#ifdef __cplusplus -} -#endif /* __cplusplus */ +G_END_DECLS #endif /* __GTK_SHEET_H__ */