gtkmisc.c 9.56 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3 4
/* GTK - The GIMP Toolkit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
Elliot Lee's avatar
Elliot Lee committed
6 7 8 9 10 11
 * 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
12
 * Lesser General Public License for more details.
Elliot Lee's avatar
Elliot Lee committed
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
15 16 17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18
 */
19 20

/*
21
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
22 23 24 25 26
 * 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/. 
 */

Elliot Lee's avatar
Elliot Lee committed
27 28
#include "gtkcontainer.h"
#include "gtkmisc.h"
Alexander Larsson's avatar
Alexander Larsson committed
29
#include "gtkintl.h"
Elliot Lee's avatar
Elliot Lee committed
30 31


32
enum {
Alexander Larsson's avatar
Alexander Larsson committed
33 34 35 36 37
  PROP_0,
  PROP_XALIGN,
  PROP_YALIGN,
  PROP_XPAD,
  PROP_YPAD
38 39
};

Manish Singh's avatar
Manish Singh committed
40 41 42 43 44 45 46 47 48 49 50 51 52 53
static void gtk_misc_class_init   (GtkMiscClass *klass);
static void gtk_misc_init         (GtkMisc      *misc);
static void gtk_misc_realize      (GtkWidget    *widget);
static void gtk_misc_set_property (GObject         *object,
				   guint            prop_id,
				   const GValue    *value,
				   GParamSpec      *pspec);
static void gtk_misc_get_property (GObject         *object,
				   guint            prop_id,
				   GValue          *value,
				   GParamSpec      *pspec);


GType
54
gtk_misc_get_type (void)
Elliot Lee's avatar
Elliot Lee committed
55
{
Manish Singh's avatar
Manish Singh committed
56
  static GType misc_type = 0;
Elliot Lee's avatar
Elliot Lee committed
57 58 59

  if (!misc_type)
    {
60
      static const GTypeInfo misc_info =
Elliot Lee's avatar
Elliot Lee committed
61 62
      {
	sizeof (GtkMiscClass),
Manish Singh's avatar
Manish Singh committed
63 64
	NULL,		/* base_init */
	NULL,		/* base_finalize */
65
	(GClassInitFunc) gtk_misc_class_init,
Manish Singh's avatar
Manish Singh committed
66 67
	NULL,		/* class_finalize */
	NULL,		/* class_data */
68
	sizeof (GtkMisc),
Manish Singh's avatar
Manish Singh committed
69
	0,		/* n_preallocs */
70
	(GInstanceInitFunc) gtk_misc_init,
Manish Singh's avatar
Manish Singh committed
71
	NULL,		/* value_table */
Elliot Lee's avatar
Elliot Lee committed
72 73
      };

74 75
      misc_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkMisc",
					  &misc_info, G_TYPE_FLAG_ABSTRACT);
Elliot Lee's avatar
Elliot Lee committed
76 77 78 79 80 81 82 83
    }

  return misc_type;
}

static void
gtk_misc_class_init (GtkMiscClass *class)
{
Alexander Larsson's avatar
Alexander Larsson committed
84
  GObjectClass   *gobject_class;
Elliot Lee's avatar
Elliot Lee committed
85 86
  GtkWidgetClass *widget_class;

Alexander Larsson's avatar
Alexander Larsson committed
87
  gobject_class = G_OBJECT_CLASS (class);
Elliot Lee's avatar
Elliot Lee committed
88 89
  widget_class = (GtkWidgetClass*) class;

Alexander Larsson's avatar
Alexander Larsson committed
90 91
  gobject_class->set_property = gtk_misc_set_property;
  gobject_class->get_property = gtk_misc_get_property;
92
  
Elliot Lee's avatar
Elliot Lee committed
93
  widget_class->realize = gtk_misc_realize;
Alexander Larsson's avatar
Alexander Larsson committed
94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133

  g_object_class_install_property (gobject_class,
                                   PROP_XALIGN,
                                   g_param_spec_float ("xalign",
						       _("X align"),
						       _("The horizontal alignment, from 0 (left) to 1 (right)"),
						       0.0,
						       1.0,
						       0.5,
						       G_PARAM_READWRITE));

  g_object_class_install_property (gobject_class,
                                   PROP_YALIGN,
                                   g_param_spec_float ("yalign",
						       _("Y align"),
						       _("The vertical alignment, from 0 (top) to 1 (bottom)"),
						       0.0,
						       1.0,
						       0.5,
						       G_PARAM_READWRITE));

  g_object_class_install_property (gobject_class,
                                   PROP_XPAD,
                                   g_param_spec_int ("xpad",
						     _("X pad"),
						     _("The amount of space to add on the left and right of the widget, in pixels"),
						     0,
						     G_MAXINT,
						     0,
						     G_PARAM_READWRITE));

  g_object_class_install_property (gobject_class,
                                   PROP_YPAD,
                                   g_param_spec_int ("ypad",
						     _("Y pad"),
						     _("The amount of space to add on the top and bottom of the widget, in pixels"),
						     0,
						     G_MAXINT,
						     0,
						     G_PARAM_READWRITE));
Elliot Lee's avatar
Elliot Lee committed
134 135 136 137 138 139 140 141 142 143 144
}

static void
gtk_misc_init (GtkMisc *misc)
{
  misc->xalign = 0.5;
  misc->yalign = 0.5;
  misc->xpad = 0;
  misc->ypad = 0;
}

145
static void
Alexander Larsson's avatar
Alexander Larsson committed
146 147 148 149
gtk_misc_set_property (GObject      *object,
		       guint         prop_id,
		       const GValue *value,
		       GParamSpec   *pspec)
150
{
151 152 153 154
  GtkMisc *misc;

  misc = GTK_MISC (object);

Alexander Larsson's avatar
Alexander Larsson committed
155
  switch (prop_id)
156
    {
Alexander Larsson's avatar
Alexander Larsson committed
157 158
    case PROP_XALIGN:
      gtk_misc_set_alignment (misc, g_value_get_float (value), misc->yalign);
159
      break;
Alexander Larsson's avatar
Alexander Larsson committed
160 161
    case PROP_YALIGN:
      gtk_misc_set_alignment (misc, misc->xalign, g_value_get_float (value));
162
      break;
Alexander Larsson's avatar
Alexander Larsson committed
163 164
    case PROP_XPAD:
      gtk_misc_set_padding (misc, g_value_get_int (value), misc->ypad);
165
      break;
Alexander Larsson's avatar
Alexander Larsson committed
166 167
    case PROP_YPAD:
      gtk_misc_set_padding (misc, misc->xpad, g_value_get_int (value));
168 169
      break;
    default:
Alexander Larsson's avatar
Alexander Larsson committed
170
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
171 172 173 174 175
      break;
    }
}

static void
Alexander Larsson's avatar
Alexander Larsson committed
176 177 178 179
gtk_misc_get_property (GObject      *object,
		       guint         prop_id,
		       GValue       *value,
		       GParamSpec   *pspec)
180
{
181 182 183 184
  GtkMisc *misc;

  misc = GTK_MISC (object);

Alexander Larsson's avatar
Alexander Larsson committed
185
  switch (prop_id)
186
    {
Alexander Larsson's avatar
Alexander Larsson committed
187 188
    case PROP_XALIGN:
      g_value_set_float (value, misc->xalign);
189
      break;
Alexander Larsson's avatar
Alexander Larsson committed
190 191
    case PROP_YALIGN:
      g_value_set_float (value, misc->yalign);
192
      break;
Alexander Larsson's avatar
Alexander Larsson committed
193 194
    case PROP_XPAD:
      g_value_set_int (value, misc->xpad);
195
      break;
Alexander Larsson's avatar
Alexander Larsson committed
196 197
    case PROP_YPAD:
      g_value_set_int (value, misc->ypad);
198 199
      break;
    default:
Alexander Larsson's avatar
Alexander Larsson committed
200
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
201 202 203 204
      break;
    }
}

Elliot Lee's avatar
Elliot Lee committed
205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225
void
gtk_misc_set_alignment (GtkMisc *misc,
			gfloat   xalign,
			gfloat   yalign)
{
  g_return_if_fail (GTK_IS_MISC (misc));

  if (xalign < 0.0)
    xalign = 0.0;
  else if (xalign > 1.0)
    xalign = 1.0;

  if (yalign < 0.0)
    yalign = 0.0;
  else if (yalign > 1.0)
    yalign = 1.0;

  if ((xalign != misc->xalign) || (yalign != misc->yalign))
    {
      misc->xalign = xalign;
      misc->yalign = yalign;
226
      
Elliot Lee's avatar
Elliot Lee committed
227
      /* clear the area that was allocated before the change
228 229
       */
      if (GTK_WIDGET_DRAWABLE (misc))
Elliot Lee's avatar
Elliot Lee committed
230 231
        {
          GtkWidget *widget;
232
	  
Elliot Lee's avatar
Elliot Lee committed
233
          widget = GTK_WIDGET (misc);
Manish Singh's avatar
Manish Singh committed
234
          gtk_widget_queue_draw (widget);
Elliot Lee's avatar
Elliot Lee committed
235
        }
Alexander Larsson's avatar
Alexander Larsson committed
236

Hans Breuer's avatar
Hans Breuer committed
237
      g_object_freeze_notify (G_OBJECT (misc));
Alexander Larsson's avatar
Alexander Larsson committed
238 239 240 241 242
      if (xalign != misc->xalign)
	g_object_notify (G_OBJECT (misc), "xalign");

      if (yalign != misc->yalign)
	g_object_notify (G_OBJECT (misc), "yalign");
Hans Breuer's avatar
Hans Breuer committed
243
      g_object_thaw_notify (G_OBJECT (misc));
Elliot Lee's avatar
Elliot Lee committed
244 245 246
    }
}

247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268
/**
 * gtk_misc_get_alignment:
 * @misc: a #GtkMisc
 * @xalign: location to store X alignment of @misc, or %NULL
 * @yalign: location to store Y alignment of @misc, or %NULL
 *
 * Gets the X and Y alignment of the widget within its allocation. See
 * gtk_misc_set_alignment().
 **/
void
gtk_misc_get_alignment (GtkMisc *misc,
		        gfloat  *xalign,
			gfloat  *yalign)
{
  g_return_if_fail (GTK_IS_MISC (misc));

  if (xalign)
    *xalign = misc->xalign;
  if (yalign)
    *yalign = misc->yalign;
}

Elliot Lee's avatar
Elliot Lee committed
269 270 271 272 273 274
void
gtk_misc_set_padding (GtkMisc *misc,
		      gint     xpad,
		      gint     ypad)
{
  GtkRequisition *requisition;
275
  
Elliot Lee's avatar
Elliot Lee committed
276
  g_return_if_fail (GTK_IS_MISC (misc));
277
  
Elliot Lee's avatar
Elliot Lee committed
278 279 280 281
  if (xpad < 0)
    xpad = 0;
  if (ypad < 0)
    ypad = 0;
282
  
Elliot Lee's avatar
Elliot Lee committed
283 284 285 286 287
  if ((xpad != misc->xpad) || (ypad != misc->ypad))
    {
      requisition = &(GTK_WIDGET (misc)->requisition);
      requisition->width -= misc->xpad * 2;
      requisition->height -= misc->ypad * 2;
288
      
Elliot Lee's avatar
Elliot Lee committed
289 290
      misc->xpad = xpad;
      misc->ypad = ypad;
291
      
Elliot Lee's avatar
Elliot Lee committed
292 293
      requisition->width += misc->xpad * 2;
      requisition->height += misc->ypad * 2;
294 295
      
      if (GTK_WIDGET_DRAWABLE (misc))
Elliot Lee's avatar
Elliot Lee committed
296
	gtk_widget_queue_resize (GTK_WIDGET (misc));
Alexander Larsson's avatar
Alexander Larsson committed
297

Hans Breuer's avatar
Hans Breuer committed
298
      g_object_freeze_notify (G_OBJECT (misc));
Alexander Larsson's avatar
Alexander Larsson committed
299 300 301 302 303
      if (xpad != misc->xpad)
	g_object_notify (G_OBJECT (misc), "xpad");

      if (ypad != misc->ypad)
	g_object_notify (G_OBJECT (misc), "ypad");
Hans Breuer's avatar
Hans Breuer committed
304
      g_object_thaw_notify (G_OBJECT (misc));
Elliot Lee's avatar
Elliot Lee committed
305 306 307
    }
}

308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328
/**
 * gtk_misc_get_padding:
 * @misc: a #GtkMisc
 * @xpad: location to store padding in the X direction, or %NULL
 * @ypad: location to store padding in the Y direction, or %NULL
 *
 * Gets the padding in the X and Y directions of the widget. See gtk_misc_set_padding().
 **/
void
gtk_misc_get_padding (GtkMisc *misc,
		      gint    *xpad,
		      gint    *ypad)
{
  g_return_if_fail (GTK_IS_MISC (misc));

  if (xpad)
    *xpad = misc->xpad;
  if (ypad)
    *ypad = misc->ypad;
}

Elliot Lee's avatar
Elliot Lee committed
329 330 331 332 333 334 335 336 337 338 339 340 341 342
static void
gtk_misc_realize (GtkWidget *widget)
{
  GtkMisc *misc;
  GdkWindowAttr attributes;
  gint attributes_mask;

  g_return_if_fail (GTK_IS_MISC (widget));

  GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
  misc = GTK_MISC (widget);

  if (GTK_WIDGET_NO_WINDOW (widget))
    {
343
      widget->window = gtk_widget_get_parent_window (widget);
Manish Singh's avatar
Manish Singh committed
344
      g_object_ref (widget->window);
Elliot Lee's avatar
Elliot Lee committed
345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
      widget->style = gtk_style_attach (widget->style, widget->window);
    }
  else
    {
      attributes.window_type = GDK_WINDOW_CHILD;
      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.visual = gtk_widget_get_visual (widget);
      attributes.colormap = gtk_widget_get_colormap (widget);
      attributes.event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK;
      attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;

360
      widget->window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
Elliot Lee's avatar
Elliot Lee committed
361 362 363 364 365 366
      gdk_window_set_user_data (widget->window, widget);

      widget->style = gtk_style_attach (widget->style, widget->window);
      gdk_window_set_back_pixmap (widget->window, NULL, TRUE);
    }
}