]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkvscale.c
Updated galician translations
[~andy/gtk] / gtk / gtkvscale.c
index 20de97401b037094b2fd04bdadd27cc9f3d806a4..af7fa4073ab8b49dc1c51aa600b6888b52b9510f 100644 (file)
 /* GTK - The GIMP Toolkit
- * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
+ * Copyright (C) 2001 Red Hat, Inc.
  *
  * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Library General Public
+ * 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
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
- * License along with this library; if not, write to the Free
- * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ * 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.
  */
-#include <stdio.h>
-#include "gtkvscale.h"
-#include "gtksignal.h"
-#include "gdk/gdkkeysyms.h"
-
-
-#define SCALE_CLASS(w)  GTK_SCALE_CLASS (GTK_OBJECT (w)->klass)
-#define RANGE_CLASS(w)  GTK_RANGE_CLASS (GTK_OBJECT (w)->klass)
 
+/*
+ * 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/.
+ */
 
-static void gtk_vscale_class_init    (GtkVScaleClass *klass);
-static void gtk_vscale_init          (GtkVScale      *vscale);
-static void gtk_vscale_realize       (GtkWidget      *widget);
-static void gtk_vscale_size_request  (GtkWidget      *widget,
-                                     GtkRequisition *requisition);
-static void gtk_vscale_size_allocate (GtkWidget      *widget,
-                                     GtkAllocation  *allocation);
-static void gtk_vscale_pos_trough    (GtkVScale      *vscale,
-                                     gint           *x,
-                                     gint           *y,
-                                     gint           *w,
-                                     gint           *h);
-static void gtk_vscale_draw_slider   (GtkRange       *range);
-static void gtk_vscale_draw_value    (GtkScale       *scale);
-static gint gtk_vscale_trough_keys   (GtkRange *range,
-                                     GdkEventKey *key,
-                                     GtkScrollType *scroll,
-                                     GtkTroughType *pos);
+#include "config.h"
 
+#include <math.h>
+#include <stdlib.h>
 
-guint
-gtk_vscale_get_type ()
-{
-  static guint vscale_type = 0;
+#include "gtkvscale.h"
+#include "gtkorientable.h"
 
-  if (!vscale_type)
-    {
-      GtkTypeInfo vscale_info =
-      {
-       "GtkVScale",
-       sizeof (GtkVScale),
-       sizeof (GtkVScaleClass),
-       (GtkClassInitFunc) gtk_vscale_class_init,
-       (GtkObjectInitFunc) gtk_vscale_init,
-       (GtkArgSetFunc) NULL,
-        (GtkArgGetFunc) NULL,
-      };
 
-      vscale_type = gtk_type_unique (gtk_scale_get_type (), &vscale_info);
-    }
+/**
+ * SECTION:gtkvscale
+ * @Short_description: A vertical slider widget for selecting a value from a range
+ * @Title: GtkVScale
+ *
+ * The #GtkVScale widget is used to allow the user to select a value using
+ * a vertical slider. To create one, use gtk_hscale_new_with_range().
+ *
+ * The position to show the current value, and the number of decimal places
+ * shown can be set using the parent #GtkScale class's functions.
+ */
 
-  return vscale_type;
-}
+G_DEFINE_TYPE (GtkVScale, gtk_vscale, GTK_TYPE_SCALE)
 
 static void
 gtk_vscale_class_init (GtkVScaleClass *class)
 {
-  GtkWidgetClass *widget_class;
-  GtkRangeClass *range_class;
-  GtkScaleClass *scale_class;
-
-  widget_class = (GtkWidgetClass*) class;
-  range_class = (GtkRangeClass*) class;
-  scale_class = (GtkScaleClass*) class;
+  GtkRangeClass *range_class = GTK_RANGE_CLASS (class);
 
-  widget_class->realize = gtk_vscale_realize;
-  widget_class->size_request = gtk_vscale_size_request;
-  widget_class->size_allocate = gtk_vscale_size_allocate;
-
-  range_class->slider_update = gtk_range_default_vslider_update;
-  range_class->trough_click = gtk_range_default_vtrough_click;
-  range_class->motion = gtk_range_default_vmotion;
-  range_class->draw_slider = gtk_vscale_draw_slider;
-  range_class->trough_keys = gtk_vscale_trough_keys;
-
-  scale_class->draw_value = gtk_vscale_draw_value;
+  range_class->slider_detail = "vscale";
 }
 
 static void
 gtk_vscale_init (GtkVScale *vscale)
 {
+  gtk_orientable_set_orientation (GTK_ORIENTABLE (vscale),
+                                  GTK_ORIENTATION_VERTICAL);
 }
-
-GtkWidget*
+/**
+ * gtk_vscale_new:
+ * @adjustment: the #GtkAdjustment which sets the range of the scale.
+ *
+ * Creates a new #GtkVScale.
+ *
+ * Returns: a new #GtkVScale.
+ */
+GtkWidget *
 gtk_vscale_new (GtkAdjustment *adjustment)
 {
-  GtkVScale *vscale;
-
-  vscale = gtk_type_new (gtk_vscale_get_type ());
-
-  if (!adjustment)
-    adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
-
-  gtk_range_set_adjustment (GTK_RANGE (vscale), adjustment);
-
-  return GTK_WIDGET (vscale);
-}
-
-
-static void
-gtk_vscale_realize (GtkWidget *widget)
-{
-  GtkRange *range;
-  GdkWindowAttr attributes;
-  gint attributes_mask;
-  gint x, y, w, h;
-
-  g_return_if_fail (widget != NULL);
-  g_return_if_fail (GTK_IS_VSCALE (widget));
-
-  GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
-  range = GTK_RANGE (widget);
-
-  attributes.x = widget->allocation.x;
-  attributes.y = widget->allocation.y;
-  attributes.width = widget->allocation.width;
-  attributes.height = widget->allocation.height;
-  attributes.wclass = GDK_INPUT_OUTPUT;
-  attributes.window_type = GDK_WINDOW_CHILD;
-  attributes.event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK;
-  attributes.visual = gtk_widget_get_visual (widget);
-  attributes.colormap = gtk_widget_get_colormap (widget);
-
-  attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
-  widget->window = gdk_window_new (widget->parent->window, &attributes, attributes_mask);
-
-  gtk_vscale_pos_trough (GTK_VSCALE (widget), &x, &y, &w, &h);
-  attributes.x = x;
-  attributes.y = y;
-  attributes.width = w;
-  attributes.height = h;
-  attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
-                           GDK_BUTTON_RELEASE_MASK |
-                           GDK_ENTER_NOTIFY_MASK |
-                           GDK_LEAVE_NOTIFY_MASK);
-
-  range->trough = gdk_window_new (widget->window, &attributes, attributes_mask);
-
-  attributes.width = RANGE_CLASS (range)->slider_width;
-  attributes.height = SCALE_CLASS (range)->slider_length;
-  attributes.event_mask |= (GDK_BUTTON_MOTION_MASK |
-                           GDK_POINTER_MOTION_HINT_MASK);
-
-  range->slider = gdk_window_new (range->trough, &attributes, attributes_mask);
-
-  widget->style = gtk_style_attach (widget->style, widget->window);
-
-  gdk_window_set_user_data (widget->window, widget);
-  gdk_window_set_user_data (range->trough, widget);
-  gdk_window_set_user_data (range->slider, widget);
-
-  gtk_style_set_background (widget->style, widget->window, GTK_STATE_NORMAL);
-  gtk_style_set_background (widget->style, range->trough, GTK_STATE_ACTIVE);
-  gtk_style_set_background (widget->style, range->slider, GTK_STATE_NORMAL);
-
-  gtk_range_slider_update (GTK_RANGE (widget));
-
-  gdk_window_show (range->slider);
-  gdk_window_show (range->trough);
-}
-
-static void
-gtk_vscale_size_request (GtkWidget      *widget,
-                        GtkRequisition *requisition)
-{
-  GtkScale *scale;
-  gint value_width;
-
-  g_return_if_fail (widget != NULL);
-  g_return_if_fail (GTK_IS_VSCALE (widget));
-  g_return_if_fail (requisition != NULL);
-
-  scale = GTK_SCALE (widget);
-
-  requisition->width = (RANGE_CLASS (scale)->slider_width +
-                       widget->style->klass->ythickness * 2);
-  requisition->height = (SCALE_CLASS (scale)->slider_length +
-                        widget->style->klass->xthickness) * 2;
-
-  if (scale->draw_value)
-    {
-      value_width = gtk_scale_value_width (scale);
-
-      if ((scale->value_pos == GTK_POS_LEFT) ||
-         (scale->value_pos == GTK_POS_RIGHT))
-       {
-         requisition->width += value_width + SCALE_CLASS (scale)->value_spacing;
-         if (requisition->height < (widget->style->font->ascent + widget->style->font->descent))
-           requisition->height = widget->style->font->ascent + widget->style->font->descent;
-       }
-      else if ((scale->value_pos == GTK_POS_TOP) ||
-              (scale->value_pos == GTK_POS_BOTTOM))
-       {
-         if (requisition->width < value_width)
-           requisition->width = value_width;
-         requisition->height += widget->style->font->ascent + widget->style->font->descent;
-       }
-    }
-}
-
-static void
-gtk_vscale_size_allocate (GtkWidget     *widget,
-                         GtkAllocation *allocation)
-{
-  GtkRange *range;
-  GtkScale *scale;
-  gint width, height;
-  gint x, y;
-
-  g_return_if_fail (widget != NULL);
-  g_return_if_fail (GTK_IS_VSCALE (widget));
-  g_return_if_fail (allocation != NULL);
-
-  widget->allocation = *allocation;
-  if (GTK_WIDGET_REALIZED (widget))
-    {
-      range = GTK_RANGE (widget);
-      scale = GTK_SCALE (widget);
-
-      gdk_window_move_resize (widget->window,
-                             allocation->x, allocation->y,
-                             allocation->width, allocation->height);
-
-      gtk_vscale_pos_trough (GTK_VSCALE (widget), &x, &y, &width, &height);
+  g_return_val_if_fail (adjustment == NULL || GTK_IS_ADJUSTMENT (adjustment),
+                        NULL);
 
-      gdk_window_move_resize (range->trough, x, y, width, height);
-      gtk_range_slider_update (GTK_RANGE (widget));
-    }
+  return g_object_new (GTK_TYPE_VSCALE,
+                       "adjustment", adjustment,
+                       NULL);
 }
 
-static void
-gtk_vscale_pos_trough (GtkVScale *vscale,
-                      gint      *x,
-                      gint      *y,
-                      gint      *w,
-                      gint      *h)
+/**
+ * gtk_vscale_new_with_range:
+ * @min: minimum value
+ * @max: maximum value
+ * @step: step increment (tick size) used with keyboard shortcuts
+ *
+ * Creates a new vertical scale widget that lets the user input a
+ * number between @min and @max (including @min and @max) with the
+ * increment @step.  @step must be nonzero; it's the distance the
+ * slider moves when using the arrow keys to adjust the scale value.
+ *
+ * Note that the way in which the precision is derived works best if @step
+ * is a power of ten. If the resulting precision is not suitable for your
+ * needs, use gtk_scale_set_digits() to correct it.
+ *
+ * Return value: a new #GtkVScale
+ **/
+GtkWidget *
+gtk_vscale_new_with_range (gdouble min,
+                           gdouble max,
+                           gdouble step)
 {
-  GtkWidget *widget;
+  GtkAdjustment *adj;
   GtkScale *scale;
+  gint digits;
 
-  g_return_if_fail (vscale != NULL);
-  g_return_if_fail (GTK_IS_VSCALE (vscale));
-  g_return_if_fail ((x != NULL) && (y != NULL) && (w != NULL) && (h != NULL));
-
-  widget = GTK_WIDGET (vscale);
-  scale = GTK_SCALE (vscale);
+  g_return_val_if_fail (min < max, NULL);
+  g_return_val_if_fail (step != 0.0, NULL);
 
-  *w = (RANGE_CLASS (scale)->slider_width +
-       widget->style->klass->xthickness * 2);
-  *h = widget->allocation.height;
+  adj = gtk_adjustment_new (min, min, max, step, 10 * step, 0);
 
-  if (scale->draw_value)
+  if (fabs (step) >= 1.0 || step == 0.0)
     {
-      *x = 0;
-      *y = 0;
-
-      switch (scale->value_pos)
-       {
-       case GTK_POS_LEFT:
-         *x = (gtk_scale_value_width (scale) +
-               (widget->allocation.width - widget->requisition.width) / 2);
-         break;
-       case GTK_POS_RIGHT:
-         *x = (widget->allocation.width - widget->requisition.width) / 2;
-         break;
-       case GTK_POS_TOP:
-         *x = (widget->allocation.width - *w) / 2;
-         *y = widget->style->font->ascent + widget->style->font->descent;
-         *h -= *y;
-         break;
-       case GTK_POS_BOTTOM:
-         *x = (widget->allocation.width - *w) / 2;
-         *h -= widget->style->font->ascent + widget->style->font->descent;
-         break;
-       }
+      digits = 0;
     }
   else
     {
-      *x = (widget->allocation.width - *w) / 2;
-      *y = 0;
-    }
-  *y += 1;
-  *h -= 2;
-}
-
-static void
-gtk_vscale_draw_slider (GtkRange *range)
-{
-  GtkStateType state_type;
-  gint width, height;
-
-  g_return_if_fail (range != NULL);
-  g_return_if_fail (GTK_IS_VSCALE (range));
-
-  if (range->slider)
-    {
-      if ((range->in_child == RANGE_CLASS (range)->slider) ||
-          (range->click_child == RANGE_CLASS (range)->slider))
-        state_type = GTK_STATE_PRELIGHT;
-      else
-        state_type = GTK_STATE_NORMAL;
-
-      gtk_style_set_background (GTK_WIDGET (range)->style, range->slider, state_type);
-      gdk_window_clear (range->slider);
-
-      gdk_window_get_size (range->slider, &width, &height);
-      gtk_draw_hline (GTK_WIDGET (range)->style, range->slider,
-                     state_type, 1, width - 2, height / 2);
-
-      gtk_draw_shadow (GTK_WIDGET (range)->style, range->slider,
-                       state_type, GTK_SHADOW_OUT,
-                       0, 0, -1, -1);
+      digits = abs ((gint) floor (log10 (fabs (step))));
+      if (digits > 5)
+        digits = 5;
     }
-}
-
-static void
-gtk_vscale_draw_value (GtkScale *scale)
-{
-  GtkStateType state_type;
-  gchar buffer[16];
-  gint text_width;
-  gint width, height;
-  gint x, y;
-
-  g_return_if_fail (scale != NULL);
-  g_return_if_fail (GTK_IS_VSCALE (scale));
-
-  if (scale->draw_value)
-    {
-      gdk_window_get_size (GTK_WIDGET (scale)->window, &width, &height);
-      gdk_window_clear_area (GTK_WIDGET (scale)->window, 1, 1, width - 3, height - 3);
 
-      sprintf (buffer, "%0.*f", GTK_RANGE (scale)->digits, GTK_RANGE (scale)->adjustment->value);
-      text_width = gdk_string_measure (GTK_WIDGET (scale)->style->font, buffer);
+  scale = g_object_new (GTK_TYPE_VSCALE,
+                        "adjustment", adj,
+                        "digits", digits,
+                        NULL);
 
-      switch (scale->value_pos)
-       {
-       case GTK_POS_LEFT:
-         gdk_window_get_position (GTK_RANGE (scale)->trough, &x, NULL);
-         gdk_window_get_position (GTK_RANGE (scale)->slider, NULL, &y);
-         gdk_window_get_size (GTK_RANGE (scale)->trough, &width, NULL);
-         gdk_window_get_size (GTK_RANGE (scale)->slider, NULL, &height);
-
-         x -= SCALE_CLASS (scale)->value_spacing + text_width;
-         y += ((height -
-                (GTK_WIDGET (scale)->style->font->ascent +
-                 GTK_WIDGET (scale)->style->font->descent)) / 2 +
-               GTK_WIDGET (scale)->style->font->ascent);
-         break;
-       case GTK_POS_RIGHT:
-         gdk_window_get_position (GTK_RANGE (scale)->trough, &x, NULL);
-         gdk_window_get_position (GTK_RANGE (scale)->slider, NULL, &y);
-         gdk_window_get_size (GTK_RANGE (scale)->trough, &width, NULL);
-         gdk_window_get_size (GTK_RANGE (scale)->slider, NULL, &height);
-
-         x += width + SCALE_CLASS (scale)->value_spacing;
-         y += ((height -
-                (GTK_WIDGET (scale)->style->font->ascent +
-                 GTK_WIDGET (scale)->style->font->descent)) / 2 +
-               GTK_WIDGET (scale)->style->font->ascent);
-         break;
-       case GTK_POS_TOP:
-         gdk_window_get_position (GTK_RANGE (scale)->trough, &x, &y);
-         gdk_window_get_size (GTK_RANGE (scale)->slider, &width, NULL);
-         gdk_window_get_size (GTK_RANGE (scale)->trough, NULL, &height);
-
-         x += (width - text_width) / 2;
-         y -= GTK_WIDGET (scale)->style->font->descent;
-         break;
-       case GTK_POS_BOTTOM:
-         gdk_window_get_position (GTK_RANGE (scale)->trough, &x, &y);
-         gdk_window_get_size (GTK_RANGE (scale)->slider, &width, NULL);
-         gdk_window_get_size (GTK_RANGE (scale)->trough, NULL, &height);
-
-         x += (width - text_width) / 2;
-         y += height + GTK_WIDGET (scale)->style->font->ascent;
-         break;
-       }
-
-      state_type = GTK_STATE_NORMAL;
-      if (!GTK_WIDGET_IS_SENSITIVE (scale))
-       state_type = GTK_STATE_INSENSITIVE;
-
-      gtk_draw_string (GTK_WIDGET (scale)->style,
-                      GTK_WIDGET (scale)->window,
-                      state_type, x, y, buffer);
-    }
-}
-
-static gint
-gtk_vscale_trough_keys(GtkRange *range,
-                      GdkEventKey *key,
-                      GtkScrollType *scroll,
-                      GtkTroughType *pos)
-{
-  gint return_val = FALSE;
-  switch (key->keyval)
-    {
-    case GDK_Up:
-      return_val = TRUE;
-      *scroll = GTK_SCROLL_STEP_BACKWARD;
-      break;
-    case GDK_Down:
-      return_val = TRUE;
-      *scroll = GTK_SCROLL_STEP_FORWARD;
-      break;
-    case GDK_Page_Up:
-      return_val = TRUE;
-      *scroll = GTK_SCROLL_PAGE_BACKWARD;
-      break;
-    case GDK_Page_Down:
-      return_val = TRUE;
-      *scroll = GTK_SCROLL_PAGE_FORWARD;
-      break;
-    case GDK_Home:
-      return_val = TRUE;
-      *pos = GTK_TROUGH_START;
-      break;
-    case GDK_End:
-      return_val = TRUE;
-      *pos = GTK_TROUGH_END;
-      break;
-    }
-  return return_val;
+  return GTK_WIDGET (scale);
 }