aboutsummaryrefslogblamecommitdiffstats
path: root/widgets/misc/e-selection-model.h
blob: 0326aa60e54b82d41ae3a4d94aa3657e4781e271 (plain) (tree)
1
                                                                           





















                                                                      




                              
                          










                                                                                                               

                          

                                                
      




                          
                            






                           

                                

                          




                                    
                             






                                                                                                          

                                        



                                                                                       
 



                                                                                




                  



                                                                                   

                       





















                                                                                
 
                       









                                                                              


                               















                                                                               
 
             








                                                                                






                                  
 
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/* 
 * e-selection-model.h
 * Copyright 2000, 2001, Ximian, Inc.
 *
 * Authors:
 *   Chris Lahey <clahey@ximian.com>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License, version 2, as published by the Free Software Foundation.
 *
 * 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.
 */

#ifndef _E_SELECTION_MODEL_H_
#define _E_SELECTION_MODEL_H_

#include <gtk/gtkobject.h>
#include <gal/util/e-sorter.h>
#include <gdk/gdkevents.h>

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

#define E_SELECTION_MODEL_TYPE        (e_selection_model_get_type ())
#define E_SELECTION_MODEL(o)          (GTK_CHECK_CAST ((o), E_SELECTION_MODEL_TYPE, ESelectionModel))
#define E_SELECTION_MODEL_CLASS(k)    (GTK_CHECK_CLASS_CAST((k), E_SELECTION_MODEL_TYPE, ESelectionModelClass))
#define E_IS_SELECTION_MODEL(o)       (GTK_CHECK_TYPE ((o), E_SELECTION_MODEL_TYPE))
#define E_IS_SELECTION_MODEL_CLASS(k) (GTK_CHECK_CLASS_TYPE ((k), E_SELECTION_MODEL_TYPE))

#ifndef _E_FOREACH_FUNC_H_
#define _E_FOREACH_FUNC_H_
typedef void (*EForeachFunc) (int model_row,
                  gpointer closure);
#endif

/* list selection modes */
typedef enum {
    E_CURSOR_LINE,
    E_CURSOR_SIMPLE,
    E_CURSOR_SPREADSHEET
} ECursorMode;

typedef struct {
    GtkObject     base;

    ESorter *sorter;

    GtkSelectionMode mode;
    ECursorMode cursor_mode;

    int old_selection;
} ESelectionModel;

typedef struct {
    GtkObjectClass parent_class;

    /* Virtual methods */
    gboolean (*is_row_selected)       (ESelectionModel *esm, int row);
    void     (*foreach)               (ESelectionModel *esm, EForeachFunc callback, gpointer closure);
    void     (*clear)                 (ESelectionModel *esm);
    gint     (*selected_count)        (ESelectionModel *esm);
    void     (*select_all)            (ESelectionModel *esm);
    void     (*invert_selection)      (ESelectionModel *esm);
    int      (*row_count)             (ESelectionModel *esm);

    /* Protected virtual methods. */
    void     (*change_one_row)        (ESelectionModel *esm, int row, gboolean on);
    void     (*change_cursor)         (ESelectionModel *esm, int row, int col);
    int      (*cursor_row)            (ESelectionModel *esm);
    int      (*cursor_col)            (ESelectionModel *esm);

    void     (*select_single_row)     (ESelectionModel *selection, int row);
    void     (*toggle_single_row)     (ESelectionModel *selection, int row);
    void     (*move_selection_end)    (ESelectionModel *selection, int row);
    void     (*set_selection_end)     (ESelectionModel *selection, int row);

    /*
     * Signals
     */

    void     (*cursor_changed)        (ESelectionModel *esm, int row, int col);
    void     (*cursor_activated)      (ESelectionModel *esm, int row, int col);
    void     (*selection_row_changed) (ESelectionModel *esm, int row);
    void     (*selection_changed)     (ESelectionModel *esm);

} ESelectionModelClass;


GtkType   e_selection_model_get_type               (void);
void      e_selection_model_do_something           (ESelectionModel *esm,
                            guint            row,
                            guint            col,
                            GdkModifierType  state);
gboolean  e_selection_model_maybe_do_something     (ESelectionModel *esm,
                            guint            row,
                            guint            col,
                            GdkModifierType  state);
void      e_selection_model_right_click_down       (ESelectionModel *selection,
                            guint            row,
                            guint            col,
                            GdkModifierType  state);
void      e_selection_model_right_click_up         (ESelectionModel *selection);
gint      e_selection_model_key_press              (ESelectionModel *esm,
                            GdkEventKey     *key);
void      e_selection_model_select_as_key_press    (ESelectionModel *esm,
                            guint            row,
                            guint            col,
                            GdkModifierType  state);

/* Virtual functions */
gboolean  e_selection_model_is_row_selected        (ESelectionModel *esm,
                            gint             n);
void      e_selection_model_foreach                (ESelectionModel *esm,
                            EForeachFunc     callback,
                            gpointer         closure);
void      e_selection_model_clear                  (ESelectionModel *esm);
gint      e_selection_model_selected_count         (ESelectionModel *esm);
void      e_selection_model_select_all             (ESelectionModel *esm);
void      e_selection_model_invert_selection       (ESelectionModel *esm);
int       e_selection_model_row_count              (ESelectionModel *esm);


/* Private virtual Functions */
void      e_selection_model_change_one_row         (ESelectionModel *esm,
                            int              row,
                            gboolean         on);
void      e_selection_model_change_cursor          (ESelectionModel *esm,
                            int              row,
                            int              col);
int       e_selection_model_cursor_row             (ESelectionModel *esm);
int       e_selection_model_cursor_col             (ESelectionModel *esm);
void      e_selection_model_select_single_row      (ESelectionModel *selection,
                            int              row);
void      e_selection_model_toggle_single_row      (ESelectionModel *selection,
                            int              row);
void      e_selection_model_move_selection_end     (ESelectionModel *selection,
                            int              row);
void      e_selection_model_set_selection_end      (ESelectionModel *selection,
                            int              row);

/* Signals */
void      e_selection_model_cursor_changed         (ESelectionModel *selection,
                            int              row,
                            int              col);
void      e_selection_model_cursor_activated       (ESelectionModel *selection,
                            int              row,
                            int              col);
void      e_selection_model_selection_row_changed  (ESelectionModel *selection,
                            int              row);
void      e_selection_model_selection_changed      (ESelectionModel *selection);

#ifdef __cplusplus
}
#endif /* __cplusplus */


#endif /* _E_SELECTION_MODEL_H_ */