]> Pileus Git - ~andy/gtk/blob - gtk/gtkcolorsel.h
Fix #105497; constify uses of GdkColor.
[~andy/gtk] / gtk / gtkcolorsel.h
1 /* GTK - The GIMP Toolkit
2  * Copyright (C) 2000 Red Hat, Inc. 
3  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18  * Boston, MA 02111-1307, USA.
19  */
20
21 /*
22  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
23  * file for a list of people on the GTK+ Team.  See the ChangeLog
24  * files for a list of changes.  These files are distributed with
25  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
26  */
27 #ifndef __GTK_COLOR_SELECTION_H__
28 #define __GTK_COLOR_SELECTION_H__
29
30 #include <gtk/gtkdialog.h>
31 #include <gtk/gtkvbox.h>
32
33 #ifdef __cplusplus
34 extern "C" {
35 #endif /* __cplusplus */
36
37
38 #define GTK_TYPE_COLOR_SELECTION                        (gtk_color_selection_get_type ())
39 #define GTK_COLOR_SELECTION(obj)                        (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_COLOR_SELECTION, GtkColorSelection))
40 #define GTK_COLOR_SELECTION_CLASS(klass)                (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_COLOR_SELECTION, GtkColorSelectionClass))
41 #define GTK_IS_COLOR_SELECTION(obj)                     (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_COLOR_SELECTION))
42 #define GTK_IS_COLOR_SELECTION_CLASS(klass)             (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_COLOR_SELECTION))
43 #define GTK_COLOR_SELECTION_GET_CLASS(obj)              (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_COLOR_SELECTION, GtkColorSelectionClass))
44
45
46 typedef struct _GtkColorSelection       GtkColorSelection;
47 typedef struct _GtkColorSelectionClass  GtkColorSelectionClass;
48
49
50 typedef void (* GtkColorSelectionChangePaletteFunc) (const GdkColor    *colors,
51                                                      gint               n_colors);
52 typedef void (* GtkColorSelectionChangePaletteWithScreenFunc) (GdkScreen         *screen,
53                                                                const GdkColor    *colors,
54                                                                gint               n_colors);
55
56 struct _GtkColorSelection
57 {
58   GtkVBox parent_instance;
59
60   /* < private_data > */
61   gpointer private_data;
62 };
63
64 struct _GtkColorSelectionClass
65 {
66   GtkVBoxClass parent_class;
67
68   void (*color_changed) (GtkColorSelection *color_selection);
69
70   /* Padding for future expansion */
71   void (*_gtk_reserved1) (void);
72   void (*_gtk_reserved2) (void);
73   void (*_gtk_reserved3) (void);
74   void (*_gtk_reserved4) (void);
75 };
76
77
78 /* ColorSelection */
79
80 GType      gtk_color_selection_get_type                (void) G_GNUC_CONST;
81 GtkWidget *gtk_color_selection_new                     (void);
82 gboolean   gtk_color_selection_get_has_opacity_control (GtkColorSelection *colorsel);
83 void       gtk_color_selection_set_has_opacity_control (GtkColorSelection *colorsel,
84                                                         gboolean           has_opacity);
85 gboolean   gtk_color_selection_get_has_palette         (GtkColorSelection *colorsel);
86 void       gtk_color_selection_set_has_palette         (GtkColorSelection *colorsel,
87                                                         gboolean           has_palette);
88
89
90 void     gtk_color_selection_set_current_color   (GtkColorSelection *colorsel,
91                                                   const GdkColor    *color);
92 void     gtk_color_selection_set_current_alpha   (GtkColorSelection *colorsel,
93                                                   guint16            alpha);
94 void     gtk_color_selection_get_current_color   (GtkColorSelection *colorsel,
95                                                   GdkColor          *color);
96 guint16  gtk_color_selection_get_current_alpha   (GtkColorSelection *colorsel);
97 void     gtk_color_selection_set_previous_color  (GtkColorSelection *colorsel,
98                                                   const GdkColor    *color);
99 void     gtk_color_selection_set_previous_alpha  (GtkColorSelection *colorsel,
100                                                   guint16            alpha);
101 void     gtk_color_selection_get_previous_color  (GtkColorSelection *colorsel,
102                                                   GdkColor          *color);
103 guint16  gtk_color_selection_get_previous_alpha  (GtkColorSelection *colorsel);
104
105 gboolean gtk_color_selection_is_adjusting        (GtkColorSelection *colorsel);
106
107 gboolean gtk_color_selection_palette_from_string (const gchar       *str,
108                                                   GdkColor         **colors,
109                                                   gint              *n_colors);
110 gchar*   gtk_color_selection_palette_to_string   (const GdkColor    *colors,
111                                                   gint               n_colors);
112
113 #ifndef GTK_DISABLE_DEPRECATED
114 #ifndef GDK_MULTIHEAD_SAFE
115 GtkColorSelectionChangePaletteFunc           gtk_color_selection_set_change_palette_hook             (GtkColorSelectionChangePaletteFunc           func);
116 #endif
117 #endif
118
119 GtkColorSelectionChangePaletteWithScreenFunc gtk_color_selection_set_change_palette_with_screen_hook (GtkColorSelectionChangePaletteWithScreenFunc func);
120
121 #ifndef GTK_DISABLE_DEPRECATED
122 /* Deprecated calls: */
123 void gtk_color_selection_set_color         (GtkColorSelection *colorsel,
124                                             gdouble           *color);
125 void gtk_color_selection_get_color         (GtkColorSelection *colorsel,
126                                             gdouble           *color);
127 void gtk_color_selection_set_update_policy (GtkColorSelection *colorsel,
128                                             GtkUpdateType      policy);
129 #endif /* GTK_DISABLE_DEPRECATED */
130
131 #ifdef __cplusplus
132 }
133 #endif /* __cplusplus */
134
135
136 #endif /* __GTK_COLOR_SELECTION_H__ */