1/* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18/*
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 */
24
25#ifndef __GTK_RANGE_H__
26#define __GTK_RANGE_H__
27
28
29#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
30#error "Only <gtk/gtk.h> can be included directly."
31#endif
32
33#include <gtk/gtkwidget.h>
34
35
36G_BEGIN_DECLS
37
38
39#define GTK_TYPE_RANGE (gtk_range_get_type ())
40#define GTK_RANGE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_RANGE, GtkRange))
41#define GTK_RANGE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_RANGE, GtkRangeClass))
42#define GTK_IS_RANGE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_RANGE))
43#define GTK_IS_RANGE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_RANGE))
44#define GTK_RANGE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_RANGE, GtkRangeClass))
45
46typedef struct _GtkRange GtkRange;
47typedef struct _GtkRangePrivate GtkRangePrivate;
48typedef struct _GtkRangeClass GtkRangeClass;
49
50struct _GtkRange
51{
52 GtkWidget widget;
53
54 GtkRangePrivate *priv;
55};
56
57struct _GtkRangeClass
58{
59 GtkWidgetClass parent_class;
60
61 /* what detail to pass to GTK drawing functions */
62 G_GNUC_DEPRECATED gchar *slider_detail;
63 G_GNUC_DEPRECATED gchar *stepper_detail;
64
65 void (* value_changed) (GtkRange *range);
66 void (* adjust_bounds) (GtkRange *range,
67 gdouble new_value);
68
69 /* action signals for keybindings */
70 void (* move_slider) (GtkRange *range,
71 GtkScrollType scroll);
72
73 /* Virtual functions */
74 void (* get_range_border) (GtkRange *range,
75 GtkBorder *border_);
76
77 gboolean (* change_value) (GtkRange *range,
78 GtkScrollType scroll,
79 gdouble new_value);
80
81 void (* get_range_size_request) (GtkRange *range,
82 GtkOrientation orientation,
83 gint *minimum,
84 gint *natural);
85
86 /* Padding for future expansion */
87 void (*_gtk_reserved1) (void);
88 void (*_gtk_reserved2) (void);
89 void (*_gtk_reserved3) (void);
90};
91
92
93GDK_AVAILABLE_IN_ALL
94GType gtk_range_get_type (void) G_GNUC_CONST;
95
96GDK_AVAILABLE_IN_ALL
97void gtk_range_set_adjustment (GtkRange *range,
98 GtkAdjustment *adjustment);
99GDK_AVAILABLE_IN_ALL
100GtkAdjustment* gtk_range_get_adjustment (GtkRange *range);
101
102GDK_AVAILABLE_IN_ALL
103void gtk_range_set_inverted (GtkRange *range,
104 gboolean setting);
105GDK_AVAILABLE_IN_ALL
106gboolean gtk_range_get_inverted (GtkRange *range);
107
108GDK_AVAILABLE_IN_ALL
109void gtk_range_set_flippable (GtkRange *range,
110 gboolean flippable);
111GDK_AVAILABLE_IN_ALL
112gboolean gtk_range_get_flippable (GtkRange *range);
113
114GDK_AVAILABLE_IN_ALL
115void gtk_range_set_slider_size_fixed (GtkRange *range,
116 gboolean size_fixed);
117GDK_AVAILABLE_IN_ALL
118gboolean gtk_range_get_slider_size_fixed (GtkRange *range);
119
120GDK_DEPRECATED_IN_3_20
121void gtk_range_set_min_slider_size (GtkRange *range,
122 gint min_size);
123GDK_DEPRECATED_IN_3_20
124gint gtk_range_get_min_slider_size (GtkRange *range);
125
126GDK_AVAILABLE_IN_ALL
127void gtk_range_get_range_rect (GtkRange *range,
128 GdkRectangle *range_rect);
129GDK_AVAILABLE_IN_ALL
130void gtk_range_get_slider_range (GtkRange *range,
131 gint *slider_start,
132 gint *slider_end);
133
134GDK_AVAILABLE_IN_ALL
135void gtk_range_set_lower_stepper_sensitivity (GtkRange *range,
136 GtkSensitivityType sensitivity);
137GDK_AVAILABLE_IN_ALL
138GtkSensitivityType gtk_range_get_lower_stepper_sensitivity (GtkRange *range);
139GDK_AVAILABLE_IN_ALL
140void gtk_range_set_upper_stepper_sensitivity (GtkRange *range,
141 GtkSensitivityType sensitivity);
142GDK_AVAILABLE_IN_ALL
143GtkSensitivityType gtk_range_get_upper_stepper_sensitivity (GtkRange *range);
144
145GDK_AVAILABLE_IN_ALL
146void gtk_range_set_increments (GtkRange *range,
147 gdouble step,
148 gdouble page);
149GDK_AVAILABLE_IN_ALL
150void gtk_range_set_range (GtkRange *range,
151 gdouble min,
152 gdouble max);
153GDK_AVAILABLE_IN_ALL
154void gtk_range_set_value (GtkRange *range,
155 gdouble value);
156GDK_AVAILABLE_IN_ALL
157gdouble gtk_range_get_value (GtkRange *range);
158
159GDK_AVAILABLE_IN_ALL
160void gtk_range_set_show_fill_level (GtkRange *range,
161 gboolean show_fill_level);
162GDK_AVAILABLE_IN_ALL
163gboolean gtk_range_get_show_fill_level (GtkRange *range);
164GDK_AVAILABLE_IN_ALL
165void gtk_range_set_restrict_to_fill_level (GtkRange *range,
166 gboolean restrict_to_fill_level);
167GDK_AVAILABLE_IN_ALL
168gboolean gtk_range_get_restrict_to_fill_level (GtkRange *range);
169GDK_AVAILABLE_IN_ALL
170void gtk_range_set_fill_level (GtkRange *range,
171 gdouble fill_level);
172GDK_AVAILABLE_IN_ALL
173gdouble gtk_range_get_fill_level (GtkRange *range);
174GDK_AVAILABLE_IN_ALL
175void gtk_range_set_round_digits (GtkRange *range,
176 gint round_digits);
177GDK_AVAILABLE_IN_ALL
178gint gtk_range_get_round_digits (GtkRange *range);
179
180
181G_END_DECLS
182
183
184#endif /* __GTK_RANGE_H__ */
185