2004-01-26 Federico Mena Quintero <federico@ximian.com> Fix #105497; constify uses of GdkColor. * gdk/gdkgc.c (gdk_gc_set_rgb_fg_color): Constify. (gdk_gc_set_rgb_bg_color): Constify. (gdk_gc_set_foreground): Constify. * gdk/x11/gdkcursor-x11.c (gdk_cursor_new_from_pixmap): Constify. * gdk/win32/gdkcursor-win32.c (gdk_cursor_new_from_pixmap): Constify. * gdk/linux-fb/gdkcursor-fb.c (gdk_cursor_new_from_pixmap): Constify. * gdk/x11/gdkpixmap-x11.c (gdk_pixmap_create_from_data): Constify. * gdk/win32/gdkpixmap-win32.c (gdk_pixmap_create_from_data): Constify. * gdk/linux-fb/gdkpixmap-fb.c (gdk_pixmap_create_from_data): Constify. * gdk/x11/gdkwindow-x11.c (gdk_window_set_background): Constify. * gdk/win32/gdkwindow-win32.c (gdk_window_set_background): Constify. * gdk/linux-fb/gdkwindow-fb.c (gdk_window_set_background): Constify. * gdk/gdkpango.c (gdk_draw_layout_line_with_colors): Constify. (gdk_draw_layout_with_colors): Constify. * gdk/gdkpixmap.c (gdk_pixmap_colormap_new_from_pixbuf): Constify. (gdk_pixmap_colormap_create_from_xpm): Constify. (gdk_pixmap_create_from_xpm): Constify. (gdk_pixmap_colormap_create_from_xpm_d): Constify. (gdk_pixmap_create_from_xpm_d): Constify. * gtk/gtkcellview.c (gtk_cell_view_set_background_color): Constify. * gtk/gtkclist.c (gtk_clist_set_foreground): Constify. (gtk_clist_set_background): Constify. * gtk/gtkcolorbutton.c (gtk_color_button_new_with_color): Constify. (gtk_color_button_set_color): Constify. * gtk/gtkcolorsel.c (gtk_color_selection_set_current_color): Constify and add a check for color != NULL. (gtk_color_selection_get_current_color): Add a check for color != NULL. (gtk_color_selection_set_previous_color): Constify and add a check for color != NULL. (gtk_color_selection_get_previous_color): Add a check for color != NULL. * gtk/gtkctree.c (gtk_ctree_node_set_foreground): Constify. (gtk_ctree_node_set_background): Constify. * gtk/gtktext.c (gtk_text_insert): Constify. (insert_text_property): Constify. (text_properties_equal): Constify. (new_text_property): Constify. * gtk/gtkwidget.c (gtk_widget_modify_color_component): Constify. (gtk_widget_modify_fg): Constify. (gtk_widget_modify_bg): Constify. (gtk_widget_modify_text): Constify. (gtk_widget_modify_base): Constify.
		
			
				
	
	
		
			795 lines
		
	
	
		
			22 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			795 lines
		
	
	
		
			22 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* GTK - The GIMP Toolkit
 | 
						|
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
 | 
						|
 * Copyright (C) 1997-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
 | 
						|
 *
 | 
						|
 * This library is free software; you can redistribute it and/or
 | 
						|
 * modify it under the terms of the GNU Lesser 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
 | 
						|
 * Lesser General Public License for more details.
 | 
						|
 *
 | 
						|
 * You should have received a copy of the GNU Lesser 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.
 | 
						|
 */
 | 
						|
 | 
						|
/*
 | 
						|
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 | 
						|
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 | 
						|
 * files for a list of changes.  These files are distributed with
 | 
						|
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef GTK_DISABLE_DEPRECATED
 | 
						|
 | 
						|
#ifndef __GTK_CLIST_H__
 | 
						|
#define __GTK_CLIST_H__
 | 
						|
 | 
						|
#include <gdk/gdk.h>
 | 
						|
#include <gtk/gtksignal.h>
 | 
						|
#include <gtk/gtkalignment.h>
 | 
						|
#include <gtk/gtklabel.h>
 | 
						|
#include <gtk/gtkbutton.h>
 | 
						|
#include <gtk/gtkhscrollbar.h>
 | 
						|
#include <gtk/gtkvscrollbar.h>
 | 
						|
#include <gtk/gtkenums.h>
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#endif /* __cplusplus */
 | 
						|
 | 
						|
/* clist flags */
 | 
						|
enum {
 | 
						|
  GTK_CLIST_IN_DRAG             = 1 <<  0,
 | 
						|
  GTK_CLIST_ROW_HEIGHT_SET      = 1 <<  1,
 | 
						|
  GTK_CLIST_SHOW_TITLES         = 1 <<  2,
 | 
						|
  /* Unused */
 | 
						|
  GTK_CLIST_ADD_MODE            = 1 <<  4,
 | 
						|
  GTK_CLIST_AUTO_SORT           = 1 <<  5,
 | 
						|
  GTK_CLIST_AUTO_RESIZE_BLOCKED = 1 <<  6,
 | 
						|
  GTK_CLIST_REORDERABLE         = 1 <<  7,
 | 
						|
  GTK_CLIST_USE_DRAG_ICONS      = 1 <<  8,
 | 
						|
  GTK_CLIST_DRAW_DRAG_LINE      = 1 <<  9,
 | 
						|
  GTK_CLIST_DRAW_DRAG_RECT      = 1 << 10
 | 
						|
}; 
 | 
						|
 | 
						|
/* cell types */
 | 
						|
typedef enum
 | 
						|
{
 | 
						|
  GTK_CELL_EMPTY,
 | 
						|
  GTK_CELL_TEXT,
 | 
						|
  GTK_CELL_PIXMAP,
 | 
						|
  GTK_CELL_PIXTEXT,
 | 
						|
  GTK_CELL_WIDGET
 | 
						|
} GtkCellType;
 | 
						|
 | 
						|
typedef enum
 | 
						|
{
 | 
						|
  GTK_CLIST_DRAG_NONE,
 | 
						|
  GTK_CLIST_DRAG_BEFORE,
 | 
						|
  GTK_CLIST_DRAG_INTO,
 | 
						|
  GTK_CLIST_DRAG_AFTER
 | 
						|
} GtkCListDragPos;
 | 
						|
 | 
						|
typedef enum
 | 
						|
{
 | 
						|
  GTK_BUTTON_IGNORED = 0,
 | 
						|
  GTK_BUTTON_SELECTS = 1 << 0,
 | 
						|
  GTK_BUTTON_DRAGS   = 1 << 1,
 | 
						|
  GTK_BUTTON_EXPANDS = 1 << 2
 | 
						|
} GtkButtonAction;
 | 
						|
 | 
						|
#define GTK_TYPE_CLIST            (gtk_clist_get_type ())
 | 
						|
#define GTK_CLIST(obj)            (GTK_CHECK_CAST ((obj), GTK_TYPE_CLIST, GtkCList))
 | 
						|
#define GTK_CLIST_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_CLIST, GtkCListClass))
 | 
						|
#define GTK_IS_CLIST(obj)         (GTK_CHECK_TYPE ((obj), GTK_TYPE_CLIST))
 | 
						|
#define GTK_IS_CLIST_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CLIST))
 | 
						|
#define GTK_CLIST_GET_CLASS(obj)  (GTK_CHECK_GET_CLASS ((obj), GTK_TYPE_CLIST, GtkCListClass))
 | 
						|
 | 
						|
 | 
						|
#define GTK_CLIST_FLAGS(clist)             (GTK_CLIST (clist)->flags)
 | 
						|
#define GTK_CLIST_SET_FLAG(clist,flag)     (GTK_CLIST_FLAGS (clist) |= (GTK_ ## flag))
 | 
						|
#define GTK_CLIST_UNSET_FLAG(clist,flag)   (GTK_CLIST_FLAGS (clist) &= ~(GTK_ ## flag))
 | 
						|
 | 
						|
#define GTK_CLIST_IN_DRAG(clist)           (GTK_CLIST_FLAGS (clist) & GTK_CLIST_IN_DRAG)
 | 
						|
#define GTK_CLIST_ROW_HEIGHT_SET(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ROW_HEIGHT_SET)
 | 
						|
#define GTK_CLIST_SHOW_TITLES(clist)       (GTK_CLIST_FLAGS (clist) & GTK_CLIST_SHOW_TITLES)
 | 
						|
#define GTK_CLIST_ADD_MODE(clist)          (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ADD_MODE)
 | 
						|
#define GTK_CLIST_AUTO_SORT(clist)         (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_SORT)
 | 
						|
#define GTK_CLIST_AUTO_RESIZE_BLOCKED(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_RESIZE_BLOCKED)
 | 
						|
#define GTK_CLIST_REORDERABLE(clist)       (GTK_CLIST_FLAGS (clist) & GTK_CLIST_REORDERABLE)
 | 
						|
#define GTK_CLIST_USE_DRAG_ICONS(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_USE_DRAG_ICONS)
 | 
						|
#define GTK_CLIST_DRAW_DRAG_LINE(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_LINE)
 | 
						|
#define GTK_CLIST_DRAW_DRAG_RECT(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_RECT)
 | 
						|
 | 
						|
#define GTK_CLIST_ROW(_glist_) ((GtkCListRow *)((_glist_)->data))
 | 
						|
 | 
						|
/* pointer casting for cells */
 | 
						|
#define GTK_CELL_TEXT(cell)     (((GtkCellText *) &(cell)))
 | 
						|
#define GTK_CELL_PIXMAP(cell)   (((GtkCellPixmap *) &(cell)))
 | 
						|
#define GTK_CELL_PIXTEXT(cell)  (((GtkCellPixText *) &(cell)))
 | 
						|
#define GTK_CELL_WIDGET(cell)   (((GtkCellWidget *) &(cell)))
 | 
						|
 | 
						|
typedef struct _GtkCList GtkCList;
 | 
						|
typedef struct _GtkCListClass GtkCListClass;
 | 
						|
typedef struct _GtkCListColumn GtkCListColumn;
 | 
						|
typedef struct _GtkCListRow GtkCListRow;
 | 
						|
 | 
						|
typedef struct _GtkCell GtkCell;
 | 
						|
typedef struct _GtkCellText GtkCellText;
 | 
						|
typedef struct _GtkCellPixmap GtkCellPixmap;
 | 
						|
typedef struct _GtkCellPixText GtkCellPixText;
 | 
						|
typedef struct _GtkCellWidget GtkCellWidget;
 | 
						|
 | 
						|
typedef gint (*GtkCListCompareFunc) (GtkCList     *clist,
 | 
						|
				     gconstpointer ptr1,
 | 
						|
				     gconstpointer ptr2);
 | 
						|
 | 
						|
typedef struct _GtkCListCellInfo GtkCListCellInfo;
 | 
						|
typedef struct _GtkCListDestInfo GtkCListDestInfo;
 | 
						|
 | 
						|
struct _GtkCListCellInfo
 | 
						|
{
 | 
						|
  gint row;
 | 
						|
  gint column;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCListDestInfo
 | 
						|
{
 | 
						|
  GtkCListCellInfo cell;
 | 
						|
  GtkCListDragPos  insert_pos;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCList
 | 
						|
{
 | 
						|
  GtkContainer container;
 | 
						|
  
 | 
						|
  guint16 flags;
 | 
						|
  
 | 
						|
  /* mem chunks */
 | 
						|
  GMemChunk *row_mem_chunk;
 | 
						|
  GMemChunk *cell_mem_chunk;
 | 
						|
 | 
						|
  guint freeze_count;
 | 
						|
  
 | 
						|
  /* allocation rectangle after the conatiner_border_width
 | 
						|
   * and the width of the shadow border */
 | 
						|
  GdkRectangle internal_allocation;
 | 
						|
  
 | 
						|
  /* rows */
 | 
						|
  gint rows;
 | 
						|
  gint row_height;
 | 
						|
  GList *row_list;
 | 
						|
  GList *row_list_end;
 | 
						|
  
 | 
						|
  /* columns */
 | 
						|
  gint columns;
 | 
						|
  GdkRectangle column_title_area;
 | 
						|
  GdkWindow *title_window;
 | 
						|
  
 | 
						|
  /* dynamicly allocated array of column structures */
 | 
						|
  GtkCListColumn *column;
 | 
						|
  
 | 
						|
  /* the scrolling window and its height and width to
 | 
						|
   * make things a little speedier */
 | 
						|
  GdkWindow *clist_window;
 | 
						|
  gint clist_window_width;
 | 
						|
  gint clist_window_height;
 | 
						|
  
 | 
						|
  /* offsets for scrolling */
 | 
						|
  gint hoffset;
 | 
						|
  gint voffset;
 | 
						|
  
 | 
						|
  /* border shadow style */
 | 
						|
  GtkShadowType shadow_type;
 | 
						|
  
 | 
						|
  /* the list's selection mode (gtkenums.h) */
 | 
						|
  GtkSelectionMode selection_mode;
 | 
						|
  
 | 
						|
  /* list of selected rows */
 | 
						|
  GList *selection;
 | 
						|
  GList *selection_end;
 | 
						|
  
 | 
						|
  GList *undo_selection;
 | 
						|
  GList *undo_unselection;
 | 
						|
  gint undo_anchor;
 | 
						|
  
 | 
						|
  /* mouse buttons */
 | 
						|
  guint8 button_actions[5];
 | 
						|
 | 
						|
  guint8 drag_button;
 | 
						|
 | 
						|
  /* dnd */
 | 
						|
  GtkCListCellInfo click_cell;
 | 
						|
 | 
						|
  /* scroll adjustments */
 | 
						|
  GtkAdjustment *hadjustment;
 | 
						|
  GtkAdjustment *vadjustment;
 | 
						|
  
 | 
						|
  /* xor GC for the vertical 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 line */
 | 
						|
  gint x_drag;
 | 
						|
  
 | 
						|
  /* focus handling */
 | 
						|
  gint focus_row;
 | 
						|
 | 
						|
  gint focus_header_column;
 | 
						|
  
 | 
						|
  /* dragging the selection */
 | 
						|
  gint anchor;
 | 
						|
  GtkStateType anchor_state;
 | 
						|
  gint drag_pos;
 | 
						|
  gint htimer;
 | 
						|
  gint vtimer;
 | 
						|
  
 | 
						|
  GtkSortType sort_type;
 | 
						|
  GtkCListCompareFunc compare;
 | 
						|
  gint sort_column;
 | 
						|
 | 
						|
  gint drag_highlight_row;
 | 
						|
  GtkCListDragPos drag_highlight_pos;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCListClass
 | 
						|
{
 | 
						|
  GtkContainerClass parent_class;
 | 
						|
  
 | 
						|
  void  (*set_scroll_adjustments) (GtkCList       *clist,
 | 
						|
				   GtkAdjustment  *hadjustment,
 | 
						|
				   GtkAdjustment  *vadjustment);
 | 
						|
  void   (*refresh)             (GtkCList       *clist);
 | 
						|
  void   (*select_row)          (GtkCList       *clist,
 | 
						|
				 gint            row,
 | 
						|
				 gint            column,
 | 
						|
				 GdkEvent       *event);
 | 
						|
  void   (*unselect_row)        (GtkCList       *clist,
 | 
						|
				 gint            row,
 | 
						|
				 gint            column,
 | 
						|
				 GdkEvent       *event);
 | 
						|
  void   (*row_move)            (GtkCList       *clist,
 | 
						|
				 gint            source_row,
 | 
						|
				 gint            dest_row);
 | 
						|
  void   (*click_column)        (GtkCList       *clist,
 | 
						|
				 gint            column);
 | 
						|
  void   (*resize_column)       (GtkCList       *clist,
 | 
						|
				 gint            column,
 | 
						|
                                 gint            width);
 | 
						|
  void   (*toggle_focus_row)    (GtkCList       *clist);
 | 
						|
  void   (*select_all)          (GtkCList       *clist);
 | 
						|
  void   (*unselect_all)        (GtkCList       *clist);
 | 
						|
  void   (*undo_selection)      (GtkCList       *clist);
 | 
						|
  void   (*start_selection)     (GtkCList       *clist);
 | 
						|
  void   (*end_selection)       (GtkCList       *clist);
 | 
						|
  void   (*extend_selection)    (GtkCList       *clist,
 | 
						|
				 GtkScrollType   scroll_type,
 | 
						|
				 gfloat          position,
 | 
						|
				 gboolean        auto_start_selection);
 | 
						|
  void   (*scroll_horizontal)   (GtkCList       *clist,
 | 
						|
				 GtkScrollType   scroll_type,
 | 
						|
				 gfloat          position);
 | 
						|
  void   (*scroll_vertical)     (GtkCList       *clist,
 | 
						|
				 GtkScrollType   scroll_type,
 | 
						|
				 gfloat          position);
 | 
						|
  void   (*toggle_add_mode)     (GtkCList       *clist);
 | 
						|
  void   (*abort_column_resize) (GtkCList       *clist);
 | 
						|
  void   (*resync_selection)    (GtkCList       *clist,
 | 
						|
				 GdkEvent       *event);
 | 
						|
  GList* (*selection_find)      (GtkCList       *clist,
 | 
						|
				 gint            row_number,
 | 
						|
				 GList          *row_list_element);
 | 
						|
  void   (*draw_row)            (GtkCList       *clist,
 | 
						|
				 GdkRectangle   *area,
 | 
						|
				 gint            row,
 | 
						|
				 GtkCListRow    *clist_row);
 | 
						|
  void   (*draw_drag_highlight) (GtkCList        *clist,
 | 
						|
				 GtkCListRow     *target_row,
 | 
						|
				 gint             target_row_number,
 | 
						|
				 GtkCListDragPos  drag_pos);
 | 
						|
  void   (*clear)               (GtkCList       *clist);
 | 
						|
  void   (*fake_unselect_all)   (GtkCList       *clist,
 | 
						|
				 gint            row);
 | 
						|
  void   (*sort_list)           (GtkCList       *clist);
 | 
						|
  gint   (*insert_row)          (GtkCList       *clist,
 | 
						|
				 gint            row,
 | 
						|
				 gchar          *text[]);
 | 
						|
  void   (*remove_row)          (GtkCList       *clist,
 | 
						|
				 gint            row);
 | 
						|
  void   (*set_cell_contents)   (GtkCList       *clist,
 | 
						|
				 GtkCListRow    *clist_row,
 | 
						|
				 gint            column,
 | 
						|
				 GtkCellType     type,
 | 
						|
				 const gchar    *text,
 | 
						|
				 guint8          spacing,
 | 
						|
				 GdkPixmap      *pixmap,
 | 
						|
				 GdkBitmap      *mask);
 | 
						|
  void   (*cell_size_request)   (GtkCList       *clist,
 | 
						|
				 GtkCListRow    *clist_row,
 | 
						|
				 gint            column,
 | 
						|
				 GtkRequisition *requisition);
 | 
						|
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCListColumn
 | 
						|
{
 | 
						|
  gchar *title;
 | 
						|
  GdkRectangle area;
 | 
						|
  
 | 
						|
  GtkWidget *button;
 | 
						|
  GdkWindow *window;
 | 
						|
  
 | 
						|
  gint width;
 | 
						|
  gint min_width;
 | 
						|
  gint max_width;
 | 
						|
  GtkJustification justification;
 | 
						|
  
 | 
						|
  guint visible        : 1;  
 | 
						|
  guint width_set      : 1;
 | 
						|
  guint resizeable     : 1;
 | 
						|
  guint auto_resize    : 1;
 | 
						|
  guint button_passive : 1;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCListRow
 | 
						|
{
 | 
						|
  GtkCell *cell;
 | 
						|
  GtkStateType state;
 | 
						|
  
 | 
						|
  GdkColor foreground;
 | 
						|
  GdkColor background;
 | 
						|
  
 | 
						|
  GtkStyle *style;
 | 
						|
 | 
						|
  gpointer data;
 | 
						|
  GtkDestroyNotify destroy;
 | 
						|
  
 | 
						|
  guint fg_set     : 1;
 | 
						|
  guint bg_set     : 1;
 | 
						|
  guint selectable : 1;
 | 
						|
};
 | 
						|
 | 
						|
/* Cell Structures */
 | 
						|
struct _GtkCellText
 | 
						|
{
 | 
						|
  GtkCellType type;
 | 
						|
  
 | 
						|
  gint16 vertical;
 | 
						|
  gint16 horizontal;
 | 
						|
  
 | 
						|
  GtkStyle *style;
 | 
						|
 | 
						|
  gchar *text;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCellPixmap
 | 
						|
{
 | 
						|
  GtkCellType type;
 | 
						|
  
 | 
						|
  gint16 vertical;
 | 
						|
  gint16 horizontal;
 | 
						|
  
 | 
						|
  GtkStyle *style;
 | 
						|
 | 
						|
  GdkPixmap *pixmap;
 | 
						|
  GdkBitmap *mask;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCellPixText
 | 
						|
{
 | 
						|
  GtkCellType type;
 | 
						|
  
 | 
						|
  gint16 vertical;
 | 
						|
  gint16 horizontal;
 | 
						|
  
 | 
						|
  GtkStyle *style;
 | 
						|
 | 
						|
  gchar *text;
 | 
						|
  guint8 spacing;
 | 
						|
  GdkPixmap *pixmap;
 | 
						|
  GdkBitmap *mask;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCellWidget
 | 
						|
{
 | 
						|
  GtkCellType type;
 | 
						|
  
 | 
						|
  gint16 vertical;
 | 
						|
  gint16 horizontal;
 | 
						|
  
 | 
						|
  GtkStyle *style;
 | 
						|
 | 
						|
  GtkWidget *widget;
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkCell
 | 
						|
{
 | 
						|
  GtkCellType type;
 | 
						|
  
 | 
						|
  gint16 vertical;
 | 
						|
  gint16 horizontal;
 | 
						|
  
 | 
						|
  GtkStyle *style;
 | 
						|
 | 
						|
  union {
 | 
						|
    gchar *text;
 | 
						|
    
 | 
						|
    struct {
 | 
						|
      GdkPixmap *pixmap;
 | 
						|
      GdkBitmap *mask;
 | 
						|
    } pm;
 | 
						|
    
 | 
						|
    struct {
 | 
						|
      gchar *text;
 | 
						|
      guint8 spacing;
 | 
						|
      GdkPixmap *pixmap;
 | 
						|
      GdkBitmap *mask;
 | 
						|
    } pt;
 | 
						|
    
 | 
						|
    GtkWidget *widget;
 | 
						|
  } u;
 | 
						|
};
 | 
						|
 | 
						|
GtkType gtk_clist_get_type (void) G_GNUC_CONST;
 | 
						|
 | 
						|
/* create a new GtkCList */
 | 
						|
GtkWidget* gtk_clist_new             (gint   columns);
 | 
						|
GtkWidget* gtk_clist_new_with_titles (gint   columns,
 | 
						|
				      gchar *titles[]);
 | 
						|
 | 
						|
/* set adjustments of clist */
 | 
						|
void gtk_clist_set_hadjustment (GtkCList      *clist,
 | 
						|
				GtkAdjustment *adjustment);
 | 
						|
void gtk_clist_set_vadjustment (GtkCList      *clist,
 | 
						|
				GtkAdjustment *adjustment);
 | 
						|
 | 
						|
/* get adjustments of clist */
 | 
						|
GtkAdjustment* gtk_clist_get_hadjustment (GtkCList *clist);
 | 
						|
GtkAdjustment* gtk_clist_get_vadjustment (GtkCList *clist);
 | 
						|
 | 
						|
/* set the border style of the clist */
 | 
						|
void gtk_clist_set_shadow_type (GtkCList      *clist,
 | 
						|
				GtkShadowType  type);
 | 
						|
 | 
						|
/* set the clist's selection mode */
 | 
						|
void gtk_clist_set_selection_mode (GtkCList         *clist,
 | 
						|
				   GtkSelectionMode  mode);
 | 
						|
 | 
						|
/* enable clists reorder ability */
 | 
						|
void gtk_clist_set_reorderable (GtkCList *clist,
 | 
						|
				gboolean  reorderable);
 | 
						|
void gtk_clist_set_use_drag_icons (GtkCList *clist,
 | 
						|
				   gboolean  use_icons);
 | 
						|
void gtk_clist_set_button_actions (GtkCList *clist,
 | 
						|
				   guint     button,
 | 
						|
				   guint8    button_actions);
 | 
						|
 | 
						|
/* freeze all visual updates of the list, and then thaw the list after
 | 
						|
 * you have made a number of changes and the updates wil occure in a
 | 
						|
 * more efficent mannor than if you made them on a unfrozen list
 | 
						|
 */
 | 
						|
void gtk_clist_freeze (GtkCList *clist);
 | 
						|
void gtk_clist_thaw   (GtkCList *clist);
 | 
						|
 | 
						|
/* show and hide the column title buttons */
 | 
						|
void gtk_clist_column_titles_show (GtkCList *clist);
 | 
						|
void gtk_clist_column_titles_hide (GtkCList *clist);
 | 
						|
 | 
						|
/* set the column title to be a active title (responds to button presses, 
 | 
						|
 * prelights, and grabs keyboard focus), or passive where it acts as just
 | 
						|
 * a title
 | 
						|
 */
 | 
						|
void gtk_clist_column_title_active   (GtkCList *clist,
 | 
						|
				      gint      column);
 | 
						|
void gtk_clist_column_title_passive  (GtkCList *clist,
 | 
						|
				      gint      column);
 | 
						|
void gtk_clist_column_titles_active  (GtkCList *clist);
 | 
						|
void gtk_clist_column_titles_passive (GtkCList *clist);
 | 
						|
 | 
						|
/* set the title in the column title button */
 | 
						|
void gtk_clist_set_column_title (GtkCList    *clist,
 | 
						|
				 gint         column,
 | 
						|
				 const gchar *title);
 | 
						|
 | 
						|
/* returns the title of column. Returns NULL if title is not set */
 | 
						|
gchar * gtk_clist_get_column_title (GtkCList *clist,
 | 
						|
				    gint      column);
 | 
						|
 | 
						|
/* set a widget instead of a title for the column title button */
 | 
						|
void gtk_clist_set_column_widget (GtkCList  *clist,
 | 
						|
				  gint       column,
 | 
						|
				  GtkWidget *widget);
 | 
						|
 | 
						|
/* returns the column widget */
 | 
						|
GtkWidget * gtk_clist_get_column_widget (GtkCList *clist,
 | 
						|
					 gint      column);
 | 
						|
 | 
						|
/* set the justification on a column */
 | 
						|
void gtk_clist_set_column_justification (GtkCList         *clist,
 | 
						|
					 gint              column,
 | 
						|
					 GtkJustification  justification);
 | 
						|
 | 
						|
/* set visibility of a column */
 | 
						|
void gtk_clist_set_column_visibility (GtkCList *clist,
 | 
						|
				      gint      column,
 | 
						|
				      gboolean  visible);
 | 
						|
 | 
						|
/* enable/disable column resize operations by mouse */
 | 
						|
void gtk_clist_set_column_resizeable (GtkCList *clist,
 | 
						|
				      gint      column,
 | 
						|
				      gboolean  resizeable);
 | 
						|
 | 
						|
/* resize column automatically to its optimal width */
 | 
						|
void gtk_clist_set_column_auto_resize (GtkCList *clist,
 | 
						|
				       gint      column,
 | 
						|
				       gboolean  auto_resize);
 | 
						|
 | 
						|
gint gtk_clist_columns_autosize (GtkCList *clist);
 | 
						|
 | 
						|
/* return the optimal column width, i.e. maximum of all cell widths */
 | 
						|
gint gtk_clist_optimal_column_width (GtkCList *clist,
 | 
						|
				     gint      column);
 | 
						|
 | 
						|
/* set the pixel width of a column; this is a necessary step in
 | 
						|
 * creating a CList because otherwise the column width is chozen from
 | 
						|
 * the width of the column title, which will never be right
 | 
						|
 */
 | 
						|
void gtk_clist_set_column_width (GtkCList *clist,
 | 
						|
				 gint      column,
 | 
						|
				 gint      width);
 | 
						|
 | 
						|
/* set column minimum/maximum width. min/max_width < 0 => no restriction */
 | 
						|
void gtk_clist_set_column_min_width (GtkCList *clist,
 | 
						|
				     gint      column,
 | 
						|
				     gint      min_width);
 | 
						|
void gtk_clist_set_column_max_width (GtkCList *clist,
 | 
						|
				     gint      column,
 | 
						|
				     gint      max_width);
 | 
						|
 | 
						|
/* change the height of the rows, the default (height=0) is
 | 
						|
 * the hight of the current font.
 | 
						|
 */
 | 
						|
void gtk_clist_set_row_height (GtkCList *clist,
 | 
						|
			       guint     height);
 | 
						|
 | 
						|
/* scroll the viewing area of the list 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 -1 then then there is no change
 | 
						|
 */
 | 
						|
void gtk_clist_moveto (GtkCList *clist,
 | 
						|
		       gint      row,
 | 
						|
		       gint      column,
 | 
						|
		       gfloat    row_align,
 | 
						|
		       gfloat    col_align);
 | 
						|
 | 
						|
/* returns whether the row is visible */
 | 
						|
GtkVisibility gtk_clist_row_is_visible (GtkCList *clist,
 | 
						|
					gint      row);
 | 
						|
 | 
						|
/* returns the cell type */
 | 
						|
GtkCellType gtk_clist_get_cell_type (GtkCList *clist,
 | 
						|
				     gint      row,
 | 
						|
				     gint      column);
 | 
						|
 | 
						|
/* sets a given cell's text, replacing its current contents */
 | 
						|
void gtk_clist_set_text (GtkCList    *clist,
 | 
						|
			 gint         row,
 | 
						|
			 gint         column,
 | 
						|
			 const gchar *text);
 | 
						|
 | 
						|
/* for the "get" functions, any of the return pointer can be
 | 
						|
 * NULL if you are not interested
 | 
						|
 */
 | 
						|
gint gtk_clist_get_text (GtkCList  *clist,
 | 
						|
			 gint       row,
 | 
						|
			 gint       column,
 | 
						|
			 gchar    **text);
 | 
						|
 | 
						|
/* sets a given cell's pixmap, replacing its current contents */
 | 
						|
void gtk_clist_set_pixmap (GtkCList  *clist,
 | 
						|
			   gint       row,
 | 
						|
			   gint       column,
 | 
						|
			   GdkPixmap *pixmap,
 | 
						|
			   GdkBitmap *mask);
 | 
						|
 | 
						|
gint gtk_clist_get_pixmap (GtkCList   *clist,
 | 
						|
			   gint        row,
 | 
						|
			   gint        column,
 | 
						|
			   GdkPixmap **pixmap,
 | 
						|
			   GdkBitmap **mask);
 | 
						|
 | 
						|
/* sets a given cell's pixmap and text, replacing its current contents */
 | 
						|
void gtk_clist_set_pixtext (GtkCList    *clist,
 | 
						|
			    gint         row,
 | 
						|
			    gint         column,
 | 
						|
			    const gchar *text,
 | 
						|
			    guint8       spacing,
 | 
						|
			    GdkPixmap   *pixmap,
 | 
						|
			    GdkBitmap   *mask);
 | 
						|
 | 
						|
gint gtk_clist_get_pixtext (GtkCList   *clist,
 | 
						|
			    gint        row,
 | 
						|
			    gint        column,
 | 
						|
			    gchar     **text,
 | 
						|
			    guint8     *spacing,
 | 
						|
			    GdkPixmap **pixmap,
 | 
						|
			    GdkBitmap **mask);
 | 
						|
 | 
						|
/* sets the foreground color of a row, the color must already
 | 
						|
 * be allocated
 | 
						|
 */
 | 
						|
void gtk_clist_set_foreground (GtkCList       *clist,
 | 
						|
			       gint            row,
 | 
						|
			       const GdkColor *color);
 | 
						|
 | 
						|
/* sets the background color of a row, the color must already
 | 
						|
 * be allocated
 | 
						|
 */
 | 
						|
void gtk_clist_set_background (GtkCList       *clist,
 | 
						|
			       gint            row,
 | 
						|
			       const GdkColor *color);
 | 
						|
 | 
						|
/* set / get cell styles */
 | 
						|
void gtk_clist_set_cell_style (GtkCList *clist,
 | 
						|
			       gint      row,
 | 
						|
			       gint      column,
 | 
						|
			       GtkStyle *style);
 | 
						|
 | 
						|
GtkStyle *gtk_clist_get_cell_style (GtkCList *clist,
 | 
						|
				    gint      row,
 | 
						|
				    gint      column);
 | 
						|
 | 
						|
void gtk_clist_set_row_style (GtkCList *clist,
 | 
						|
			      gint      row,
 | 
						|
			      GtkStyle *style);
 | 
						|
 | 
						|
GtkStyle *gtk_clist_get_row_style (GtkCList *clist,
 | 
						|
				   gint      row);
 | 
						|
 | 
						|
/* this sets a horizontal and vertical shift for drawing
 | 
						|
 * the contents of a cell; it can be positive or negitive;
 | 
						|
 * this is particulary useful for indenting items in a column
 | 
						|
 */
 | 
						|
void gtk_clist_set_shift (GtkCList *clist,
 | 
						|
			  gint      row,
 | 
						|
			  gint      column,
 | 
						|
			  gint      vertical,
 | 
						|
			  gint      horizontal);
 | 
						|
 | 
						|
/* set/get selectable flag of a single row */
 | 
						|
void gtk_clist_set_selectable (GtkCList *clist,
 | 
						|
			       gint      row,
 | 
						|
			       gboolean  selectable);
 | 
						|
gboolean gtk_clist_get_selectable (GtkCList *clist,
 | 
						|
				   gint      row);
 | 
						|
 | 
						|
/* prepend/append returns the index of the row you just added,
 | 
						|
 * making it easier to append and modify a row
 | 
						|
 */
 | 
						|
gint gtk_clist_prepend (GtkCList    *clist,
 | 
						|
		        gchar       *text[]);
 | 
						|
gint gtk_clist_append  (GtkCList    *clist,
 | 
						|
			gchar       *text[]);
 | 
						|
 | 
						|
/* inserts a row at index row and returns the row where it was
 | 
						|
 * actually inserted (may be different from "row" in auto_sort mode)
 | 
						|
 */
 | 
						|
gint gtk_clist_insert (GtkCList    *clist,
 | 
						|
		       gint         row,
 | 
						|
		       gchar       *text[]);
 | 
						|
 | 
						|
/* removes row at index row */
 | 
						|
void gtk_clist_remove (GtkCList *clist,
 | 
						|
		       gint      row);
 | 
						|
 | 
						|
/* sets a arbitrary data pointer for a given row */
 | 
						|
void gtk_clist_set_row_data (GtkCList *clist,
 | 
						|
			     gint      row,
 | 
						|
			     gpointer  data);
 | 
						|
 | 
						|
/* sets a data pointer for a given row with destroy notification */
 | 
						|
void gtk_clist_set_row_data_full (GtkCList         *clist,
 | 
						|
			          gint              row,
 | 
						|
			          gpointer          data,
 | 
						|
				  GtkDestroyNotify  destroy);
 | 
						|
 | 
						|
/* returns the data set for a row */
 | 
						|
gpointer gtk_clist_get_row_data (GtkCList *clist,
 | 
						|
				 gint      row);
 | 
						|
 | 
						|
/* givin a data pointer, find the first (and hopefully only!)
 | 
						|
 * row that points to that data, or -1 if none do
 | 
						|
 */
 | 
						|
gint gtk_clist_find_row_from_data (GtkCList *clist,
 | 
						|
				   gpointer  data);
 | 
						|
 | 
						|
/* force selection of a row */
 | 
						|
void gtk_clist_select_row (GtkCList *clist,
 | 
						|
			   gint      row,
 | 
						|
			   gint      column);
 | 
						|
 | 
						|
/* force unselection of a row */
 | 
						|
void gtk_clist_unselect_row (GtkCList *clist,
 | 
						|
			     gint      row,
 | 
						|
			     gint      column);
 | 
						|
 | 
						|
/* undo the last select/unselect operation */
 | 
						|
void gtk_clist_undo_selection (GtkCList *clist);
 | 
						|
 | 
						|
/* clear the entire list -- this is much faster than removing
 | 
						|
 * each item with gtk_clist_remove
 | 
						|
 */
 | 
						|
void gtk_clist_clear (GtkCList *clist);
 | 
						|
 | 
						|
/* return the row column corresponding to the x and y coordinates,
 | 
						|
 * the returned values are only valid if the x and y coordinates
 | 
						|
 * are respectively to a window == clist->clist_window
 | 
						|
 */
 | 
						|
gint gtk_clist_get_selection_info (GtkCList *clist,
 | 
						|
			     	   gint      x,
 | 
						|
			     	   gint      y,
 | 
						|
			     	   gint     *row,
 | 
						|
			     	   gint     *column);
 | 
						|
 | 
						|
/* in multiple or extended mode, select all rows */
 | 
						|
void gtk_clist_select_all (GtkCList *clist);
 | 
						|
 | 
						|
/* in all modes except browse mode, deselect all rows */
 | 
						|
void gtk_clist_unselect_all (GtkCList *clist);
 | 
						|
 | 
						|
/* swap the position of two rows */
 | 
						|
void gtk_clist_swap_rows (GtkCList *clist,
 | 
						|
			  gint      row1,
 | 
						|
			  gint      row2);
 | 
						|
 | 
						|
/* move row from source_row position to dest_row position */
 | 
						|
void gtk_clist_row_move (GtkCList *clist,
 | 
						|
			 gint      source_row,
 | 
						|
			 gint      dest_row);
 | 
						|
 | 
						|
/* sets a compare function different to the default */
 | 
						|
void gtk_clist_set_compare_func (GtkCList            *clist,
 | 
						|
				 GtkCListCompareFunc  cmp_func);
 | 
						|
 | 
						|
/* the column to sort by */
 | 
						|
void gtk_clist_set_sort_column (GtkCList *clist,
 | 
						|
				gint      column);
 | 
						|
 | 
						|
/* how to sort : ascending or descending */
 | 
						|
void gtk_clist_set_sort_type (GtkCList    *clist,
 | 
						|
			      GtkSortType  sort_type);
 | 
						|
 | 
						|
/* sort the list with the current compare function */
 | 
						|
void gtk_clist_sort (GtkCList *clist);
 | 
						|
 | 
						|
/* Automatically sort upon insertion */
 | 
						|
void gtk_clist_set_auto_sort (GtkCList *clist,
 | 
						|
			      gboolean  auto_sort);
 | 
						|
 | 
						|
/* Private function for clist, ctree */
 | 
						|
 | 
						|
PangoLayout *_gtk_clist_create_cell_layout (GtkCList       *clist,
 | 
						|
					    GtkCListRow    *clist_row,
 | 
						|
					    gint            column);
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
}
 | 
						|
#endif				/* __cplusplus */
 | 
						|
 | 
						|
#endif				/* __GTK_CLIST_H__ */
 | 
						|
 | 
						|
#endif /* GTK_DISABLE_DEPRECATED */
 |