1/*
2 * GTK - The GIMP Toolkit
3 * Copyright (C) 1998, 1999 Red Hat, Inc.
4 * All rights reserved.
5 *
6 * This Library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public License as
8 * published by the Free Software Foundation; either version 2 of the
9 * License, or (at your option) any later version.
10 *
11 * This Library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
15 *
16 * You should have received a copy of the GNU Library General Public
17 * License along with the Gnome Library; see the file COPYING.LIB. If not,
18 * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
20 */
21
22/* Color picker button for GNOME
23 *
24 * Author: Federico Mena <federico@nuclecu.unam.mx>
25 *
26 * Modified by the GTK+ Team and others 2003. See the AUTHORS
27 * file for a list of people on the GTK+ Team. See the ChangeLog
28 * files for a list of changes. These files are distributed with
29 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
30 */
31
32#ifndef __GTK_COLOR_BUTTON_H__
33#define __GTK_COLOR_BUTTON_H__
34
35
36#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
37#error "Only <gtk/gtk.h> can be included directly."
38#endif
39
40#include <gtk/gtkbutton.h>
41
42G_BEGIN_DECLS
43
44
45/* The GtkColorButton widget is a simple color picker in a button.
46 * The button displays a sample of the currently selected color. When
47 * the user clicks on the button, a color selection dialog pops up.
48 * The color picker emits the "color_set" signal when the color is set.
49 */
50
51#define GTK_TYPE_COLOR_BUTTON (gtk_color_button_get_type ())
52#define GTK_COLOR_BUTTON(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButton))
53#define GTK_COLOR_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_COLOR_BUTTON, GtkColorButtonClass))
54#define GTK_IS_COLOR_BUTTON(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_COLOR_BUTTON))
55#define GTK_IS_COLOR_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_COLOR_BUTTON))
56#define GTK_COLOR_BUTTON_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_COLOR_BUTTON, GtkColorButtonClass))
57
58typedef struct _GtkColorButton GtkColorButton;
59typedef struct _GtkColorButtonClass GtkColorButtonClass;
60typedef struct _GtkColorButtonPrivate GtkColorButtonPrivate;
61
62struct _GtkColorButton {
63 GtkButton button;
64
65 /*< private >*/
66
67 GtkColorButtonPrivate *GSEAL (priv);
68};
69
70struct _GtkColorButtonClass {
71 GtkButtonClass parent_class;
72
73 void (* color_set) (GtkColorButton *cp);
74
75 /* Padding for future expansion */
76 void (*_gtk_reserved1) (void);
77 void (*_gtk_reserved2) (void);
78 void (*_gtk_reserved3) (void);
79 void (*_gtk_reserved4) (void);
80};
81
82
83GType gtk_color_button_get_type (void) G_GNUC_CONST;
84GtkWidget *gtk_color_button_new (void);
85GtkWidget *gtk_color_button_new_with_color (const GdkColor *color);
86void gtk_color_button_set_color (GtkColorButton *color_button,
87 const GdkColor *color);
88void gtk_color_button_set_alpha (GtkColorButton *color_button,
89 guint16 alpha);
90void gtk_color_button_get_color (GtkColorButton *color_button,
91 GdkColor *color);
92guint16 gtk_color_button_get_alpha (GtkColorButton *color_button);
93void gtk_color_button_set_use_alpha (GtkColorButton *color_button,
94 gboolean use_alpha);
95gboolean gtk_color_button_get_use_alpha (GtkColorButton *color_button);
96void gtk_color_button_set_title (GtkColorButton *color_button,
97 const gchar *title);
98const gchar *gtk_color_button_get_title (GtkColorButton *color_button);
99
100
101G_END_DECLS
102
103#endif /* __GTK_COLOR_BUTTON_H__ */
104