2 * This file is a part of hildon
4 * Copyright (C) 2005, 2006 Nokia Corporation, all rights reserved.
6 * Contact: Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public License
10 * as published by the Free Software Foundation; version 2.1 of
11 * the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
26 * SECTION:hildon-vvolumebar
27 * @short_description: A widget that displays a vertical volume bar.
28 * @see_also: #HildonVolumebar, #HildonHVolumebar
30 * #HildonVVolumebar is a subclass of #HildonVolumebar. It displays a
31 * vertical volume bar that allows increasing or decreasing volume
32 * within a predefined range, and muting when users click the mute icon.
34 * Here is an example that creates a vertical volume bar and connects
37 * <title>HildonVVolumebar example</title>
39 * GtkWidget *volbar = hildon_vvolumebar_new ();
40 * g_signal_connect (G_OBJECT (volbar), "mute_toggled", G_CALLBACK (mute_toggle), NULL);
41 * g_signal_connect (G_OBJECT (volbar), "level_changed", G_CALLBACK (level_change), NULL);
50 #include "hildon-vvolumebar.h"
52 #include "hildon-volumebar-range.h"
53 #include "hildon-volumebar-private.h"
56 #define DEFAULT_BAR_WIDTH 58
58 #define MINIMUM_BAR_HEIGHT 165
62 #define DEFAULT_VERTICAL_TBUTTON_WIDTH 26
64 #define DEFAULT_VERTICAL_TBUTTON_HEIGHT 26
66 #define DEFAULT_ENDING_SIZE 20
68 /* Gap to leave for mute button */
70 #define HORIZONTAL_MUTE_GAP 16
72 #define VERTICAL_MUTE_GAP 6
74 static HildonVolumebarClass* parent_class;
77 hildon_vvolumebar_class_init (HildonVVolumebarClass * klass);
80 hildon_vvolumebar_init (HildonVVolumebar * vvolumebar);
83 hildon_vvolumebar_expose (GtkWidget * widget,
84 GdkEventExpose * event);
87 hildon_vvolumebar_size_request (GtkWidget * widget,
88 GtkRequisition * requisition);
91 hildon_vvolumebar_size_allocate (GtkWidget * widget,
92 GtkAllocation * allocation);
95 * hildon_vvolumebar_get_type:
97 * Initializes and returns the type of a hildon vvolumebar.
99 * @Returns: GType of #HildonVVolumebar
102 hildon_vvolumebar_get_type (void)
104 static GType type = 0;
107 static const GTypeInfo info = {
108 sizeof (HildonVVolumebarClass),
109 NULL, /* base_init */
110 NULL, /* base_finalize */
111 (GClassInitFunc) hildon_vvolumebar_class_init, /* class_init */
112 NULL, /* class_finalize */
113 NULL, /* class_data */
114 sizeof (HildonVVolumebar),
116 (GInstanceInitFunc) hildon_vvolumebar_init,
119 g_type_register_static (HILDON_TYPE_VOLUMEBAR,
120 "HildonVVolumebar", &info, 0);
126 hildon_vvolumebar_class_init (HildonVVolumebarClass *klass)
128 GtkWidgetClass *volumebar_class = GTK_WIDGET_CLASS(klass);
130 parent_class = g_type_class_peek_parent(klass);
132 volumebar_class->size_request = hildon_vvolumebar_size_request;
133 volumebar_class->size_allocate = hildon_vvolumebar_size_allocate;
134 volumebar_class->expose_event = hildon_vvolumebar_expose;
138 hildon_vvolumebar_init (HildonVVolumebar *vvolumebar)
140 HildonVolumebarPrivate *priv;
142 priv = HILDON_VOLUMEBAR_GET_PRIVATE (vvolumebar);
145 priv->volumebar = HILDON_VOLUMEBAR_RANGE (hildon_volumebar_range_new
146 (GTK_ORIENTATION_VERTICAL));
148 gtk_widget_set_parent (GTK_WIDGET (priv->tbutton), GTK_WIDGET (vvolumebar));
149 gtk_widget_set_parent (GTK_WIDGET (priv->volumebar), GTK_WIDGET (vvolumebar));
151 gtk_scale_set_draw_value (GTK_SCALE (priv->volumebar), FALSE);
154 g_signal_connect_swapped(G_OBJECT(priv->volumebar), "value-changed",
155 G_CALLBACK(hildon_volumebar_level_change),
158 g_signal_connect_swapped(priv->tbutton, "toggled",
159 G_CALLBACK(hildon_volumebar_mute_toggled), vvolumebar);
161 /* FIXME Not sure why this is here */
162 gtk_widget_show (GTK_WIDGET (priv->volumebar));
166 * hildon_vvolumebar_new:
168 * Creates a new #HildonVVolumebar widget.
170 * Returns: a new #HildonVVolumebar
173 hildon_vvolumebar_new (void)
175 return GTK_WIDGET (g_object_new(HILDON_TYPE_VVOLUMEBAR, NULL));
179 hildon_vvolumebar_expose (GtkWidget *widget,
180 GdkEventExpose *event)
183 HildonVolumebarPrivate *priv;
185 priv = HILDON_VOLUMEBAR_GET_PRIVATE(HILDON_VOLUMEBAR(widget));
188 if (GTK_WIDGET_DRAWABLE (widget)) {
189 /* Paint background */
190 gtk_paint_box (widget->style, widget->window,
191 GTK_WIDGET_STATE (priv->volumebar), GTK_SHADOW_OUT,
192 NULL, widget, "background",
193 widget->allocation.x,
194 widget->allocation.y,
195 widget->allocation.width,
196 widget->allocation.height);
198 /* The contents of the widget can paint themselves */
199 (*GTK_WIDGET_CLASS (parent_class)->expose_event) (widget, event);
206 hildon_vvolumebar_size_request (GtkWidget *widget,
207 GtkRequisition *requisition)
209 requisition->height = MINIMUM_BAR_HEIGHT;
210 requisition->width = DEFAULT_BAR_WIDTH;
214 hildon_vvolumebar_size_allocate (GtkWidget *widget,
215 GtkAllocation *allocation)
217 HildonVolumebarPrivate *priv;
219 GtkAllocation range_allocation, button_allocation;
221 priv = HILDON_VOLUMEBAR_GET_PRIVATE(widget);
224 /* Center the widget horizontally */
225 if (allocation->width > DEFAULT_BAR_WIDTH) {
227 (allocation->width - DEFAULT_BAR_WIDTH) / 2;
228 allocation->width = DEFAULT_BAR_WIDTH;
231 GTK_WIDGET_CLASS (parent_class)->size_allocate (widget, allocation);
233 if (priv->volumebar && GTK_WIDGET_VISIBLE (priv->volumebar)) {
234 /* Allocate space for the slider */
235 range_allocation.x = allocation->x;
236 range_allocation.y = allocation->y + DEFAULT_ENDING_SIZE;
238 range_allocation.width = DEFAULT_BAR_WIDTH;
240 if (priv->tbutton && GTK_WIDGET_VISIBLE (priv->tbutton))
242 /* Leave room for the mute button */
243 range_allocation.height = MAX (0,
245 - 2 * DEFAULT_ENDING_SIZE
246 - DEFAULT_VERTICAL_TBUTTON_HEIGHT
247 - VERTICAL_MUTE_GAP);
252 range_allocation.height = MAX (0,
254 - 2 * DEFAULT_ENDING_SIZE);
257 gtk_widget_size_allocate (GTK_WIDGET (priv->volumebar),
261 if (priv->tbutton && GTK_WIDGET_VISIBLE (priv->tbutton)) {
262 /* Allocate space for the mute button */
263 button_allocation.x = allocation->x + HORIZONTAL_MUTE_GAP;
264 button_allocation.y = allocation->y + allocation->height -
265 VERTICAL_MUTE_GAP - 2 * DEFAULT_ENDING_SIZE;
266 button_allocation.width = DEFAULT_VERTICAL_TBUTTON_WIDTH;
267 button_allocation.height = DEFAULT_VERTICAL_TBUTTON_HEIGHT;
268 gtk_widget_size_allocate (GTK_WIDGET (priv->tbutton),