Pileus Git - ~andy/gtk/blob - gtk/gtkcheckbutton.c

   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, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /*
  21  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  22  * file for a list of people on the GTK+ Team.  See the ChangeLog
  23  * files for a list of changes.  These files are distributed with
  24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  25  */
  26
  27 #include "config.h"
  28
  29 #include "gtkcheckbutton.h"
  30
  31 #include "gtkbuttonprivate.h"
  32 #include "gtklabel.h"
  33
  34 #include "gtkprivate.h"
  35 #include "gtkintl.h"
  36
  37
  38 /**
  39  * SECTION:gtkcheckbutton
  40  * @Short_description: Create widgets with a discrete toggle button
  41  * @Title: GtkCheckButton
  42  * @See_also: #GtkCheckMenuItem, #GtkButton, #GtkToggleButton, #GtkRadioButton
  43  *
  44  * A #GtkCheckButton places a discrete #GtkToggleButton next to a widget,
  45  * (usually a #GtkLabel). See the section on #GtkToggleButton widgets for
  46  * more information about toggle/check buttons.
  47  *
  48  * The important signal ( #GtkToggleButton::toggled ) is also inherited from
  49  * #GtkToggleButton.
  50  */
  51
  52
  53 #define INDICATOR_SIZE     16
  54 #define INDICATOR_SPACING  2
  55
  56
  57 static void gtk_check_button_get_preferred_width  (GtkWidget          *widget,
  58                                                    gint               *minimum,
  59                                                    gint               *natural);
  60 static void gtk_check_button_get_preferred_height (GtkWidget          *widget,
  61                                                    gint               *minimum,
  62                                                    gint               *natural);
  63 static void gtk_check_button_size_allocate       (GtkWidget           *widget,
  64                                                   GtkAllocation       *allocation);
  65 static gboolean gtk_check_button_draw            (GtkWidget           *widget,
  66                                                   cairo_t             *cr);
  67 static void gtk_check_button_paint               (GtkWidget           *widget,
  68                                                   cairo_t             *cr);
  69 static void gtk_check_button_draw_indicator      (GtkCheckButton      *check_button,
  70                                                   cairo_t             *cr);
  71 static void gtk_real_check_button_draw_indicator (GtkCheckButton      *check_button,
  72                                                   cairo_t             *cr);
  73
  74 G_DEFINE_TYPE (GtkCheckButton, gtk_check_button, GTK_TYPE_TOGGLE_BUTTON)
  75
  76 static void
  77 gtk_check_button_class_init (GtkCheckButtonClass *class)
  78 {
  79   GtkWidgetClass *widget_class;
  80
  81   widget_class = (GtkWidgetClass*) class;
  82
  83   widget_class->get_preferred_width = gtk_check_button_get_preferred_width;
  84   widget_class->get_preferred_height = gtk_check_button_get_preferred_height;
  85   widget_class->size_allocate = gtk_check_button_size_allocate;
  86   widget_class->draw = gtk_check_button_draw;
  87
  88   class->draw_indicator = gtk_real_check_button_draw_indicator;
  89
  90   gtk_widget_class_set_accessible_role (widget_class, ATK_ROLE_CHECK_BOX);
  91
  92   gtk_widget_class_install_style_property (widget_class,
  93                                            g_param_spec_int ("indicator-size",
  94                                                              P_("Indicator Size"),
  95                                                              P_("Size of check or radio indicator"),
  96                                                              0,
  97                                                              G_MAXINT,
  98                                                              INDICATOR_SIZE,
  99                                                              GTK_PARAM_READABLE));
 100   gtk_widget_class_install_style_property (widget_class,
 101                                            g_param_spec_int ("indicator-spacing",
 102                                                              P_("Indicator Spacing"),
 103                                                              P_("Spacing around check or radio indicator"),
 104                                                              0,
 105                                                              G_MAXINT,
 106                                                              INDICATOR_SPACING,
 107                                                              GTK_PARAM_READABLE));
 108 }
 109
 110 static void
 111 gtk_check_button_init (GtkCheckButton *check_button)
 112 {
 113   gtk_widget_set_has_window (GTK_WIDGET (check_button), FALSE);
 114   gtk_widget_set_receives_default (GTK_WIDGET (check_button), FALSE);
 115   gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (check_button), TRUE);
 116   gtk_button_set_alignment (GTK_BUTTON (check_button), 0.0, 0.5);
 117 }
 118
 119 /**
 120  * gtk_check_button_new:
 121  *
 122  * Creates a new #GtkCheckButton.
 123  *
 124  * Returns: a #GtkWidget.
 125  */
 126 GtkWidget*
 127 gtk_check_button_new (void)
 128 {
 129   return g_object_new (GTK_TYPE_CHECK_BUTTON, NULL);
 130 }
 131
 132
 133 /**
 134  * gtk_check_button_new_with_label:
 135  * @label: the text for the check button.
 136  *
 137  * Creates a new #GtkCheckButton with a #GtkLabel to the right of it.
 138  *
 139  * Returns: a #GtkWidget.
 140  */
 141 GtkWidget*
 142 gtk_check_button_new_with_label (const gchar *label)
 143 {
 144   return g_object_new (GTK_TYPE_CHECK_BUTTON, "label", label, NULL);
 145 }
 146
 147 /**
 148  * gtk_check_button_new_with_mnemonic:
 149  * @label: The text of the button, with an underscore in front of the
 150  *   mnemonic character
 151  * @returns: a new #GtkCheckButton
 152  *
 153  * Creates a new #GtkCheckButton containing a label. The label
 154  * will be created using gtk_label_new_with_mnemonic(), so underscores
 155  * in @label indicate the mnemonic for the check button.
 156  **/
 157 GtkWidget*
 158 gtk_check_button_new_with_mnemonic (const gchar *label)
 159 {
 160   return g_object_new (GTK_TYPE_CHECK_BUTTON,
 161                        "label", label,
 162                        "use-underline", TRUE,
 163                        NULL);
 164 }
 165
 166
 167 /* This should only be called when toggle_button->draw_indicator
 168  * is true.
 169  */
 170 static void
 171 gtk_check_button_paint (GtkWidget    *widget,
 172                         cairo_t      *cr)
 173 {
 174   GtkCheckButton *check_button = GTK_CHECK_BUTTON (widget);
 175
 176   gtk_check_button_draw_indicator (check_button, cr);
 177
 178   if (gtk_widget_has_visible_focus (widget))
 179     {
 180       GtkWidget *child = gtk_bin_get_child (GTK_BIN (widget));
 181       GtkStyleContext *context;
 182       GtkStateFlags state;
 183       GtkAllocation allocation;
 184       gint border_width;
 185       gint interior_focus;
 186       gint focus_width;
 187       gint focus_pad;
 188
 189       border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
 190
 191       gtk_widget_style_get (widget,
 192                             "interior-focus", &interior_focus,
 193                             "focus-line-width", &focus_width,
 194                             "focus-padding", &focus_pad,
 195                             NULL);
 196
 197       gtk_widget_get_allocation (widget, &allocation);
 198       context = gtk_widget_get_style_context (widget);
 199       state = gtk_widget_get_state_flags (widget);
 200
 201       gtk_style_context_set_state (context, state);
 202
 203       if (interior_focus && child && gtk_widget_get_visible (child))
 204         {
 205           GtkAllocation child_allocation;
 206
 207           gtk_widget_get_allocation (child, &child_allocation);
 208           gtk_render_focus (context, cr,
 209                             child_allocation.x - allocation.x - focus_width - focus_pad,
 210                             child_allocation.y - allocation.y - focus_width - focus_pad,
 211                             child_allocation.width + 2 * (focus_width + focus_pad),
 212                             child_allocation.height + 2 * (focus_width + focus_pad));
 213         }
 214       else
 215         gtk_render_focus (context, cr,
 216                           border_width, border_width,
 217                           allocation.width - 2 * border_width,
 218                           allocation.height - 2 * border_width);
 219     }
 220 }
 221
 222 void
 223 _gtk_check_button_get_props (GtkCheckButton *check_button,
 224                              gint           *indicator_size,
 225                              gint           *indicator_spacing)
 226 {
 227   GtkWidget *widget =  GTK_WIDGET (check_button);
 228
 229   if (indicator_size)
 230     gtk_widget_style_get (widget, "indicator-size", indicator_size, NULL);
 231
 232   if (indicator_spacing)
 233     gtk_widget_style_get (widget, "indicator-spacing", indicator_spacing, NULL);
 234 }
 235
 236 static void
 237 gtk_check_button_get_preferred_width (GtkWidget *widget,
 238                                       gint      *minimum,
 239                                       gint      *natural)
 240 {
 241   GtkToggleButton *toggle_button = GTK_TOGGLE_BUTTON (widget);
 242
 243   if (gtk_toggle_button_get_mode (toggle_button))
 244     {
 245       GtkWidget *child;
 246       gint indicator_size;
 247       gint indicator_spacing;
 248       gint focus_width;
 249       gint focus_pad;
 250       guint border_width;
 251
 252       border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
 253
 254       gtk_widget_style_get (GTK_WIDGET (widget),
 255                             "focus-line-width", &focus_width,
 256                             "focus-padding", &focus_pad,
 257                             NULL);
 258       *minimum = 2 * border_width;
 259       *natural = 2 * border_width;
 260
 261       _gtk_check_button_get_props (GTK_CHECK_BUTTON (widget),
 262                                    &indicator_size, &indicator_spacing);
 263
 264       child = gtk_bin_get_child (GTK_BIN (widget));
 265       if (child && gtk_widget_get_visible (child))
 266         {
 267           gint child_min, child_nat;
 268
 269           gtk_widget_get_preferred_width (child, &child_min, &child_nat);
 270
 271           *minimum += child_min + indicator_spacing;
 272           *natural += child_nat + indicator_spacing;
 273         }
 274
 275       *minimum += (indicator_size + indicator_spacing * 2 + 2 * (focus_width + focus_pad));
 276       *natural += (indicator_size + indicator_spacing * 2 + 2 * (focus_width + focus_pad));
 277     }
 278   else
 279     GTK_WIDGET_CLASS (gtk_check_button_parent_class)->get_preferred_width (widget, minimum, natural);
 280 }
 281
 282 static void
 283 gtk_check_button_get_preferred_height (GtkWidget *widget,
 284                                        gint      *minimum,
 285                                        gint      *natural)
 286 {
 287   GtkToggleButton *toggle_button = GTK_TOGGLE_BUTTON (widget);
 288
 289   if (gtk_toggle_button_get_mode (toggle_button))
 290     {
 291       GtkWidget *child;
 292       gint temp;
 293       gint indicator_size;
 294       gint indicator_spacing;
 295       gint focus_width;
 296       gint focus_pad;
 297       guint border_width;
 298
 299       border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
 300
 301       gtk_widget_style_get (GTK_WIDGET (widget),
 302                             "focus-line-width", &focus_width,
 303                             "focus-padding", &focus_pad,
 304                             NULL);
 305
 306       *minimum = border_width * 2;
 307       *natural = border_width * 2;
 308
 309       _gtk_check_button_get_props (GTK_CHECK_BUTTON (widget),
 310                                    &indicator_size, &indicator_spacing);
 311
 312       child = gtk_bin_get_child (GTK_BIN (widget));
 313       if (child && gtk_widget_get_visible (child))
 314         {
 315           gint child_min, child_nat;
 316
 317           gtk_widget_get_preferred_height (child, &child_min, &child_nat);
 318
 319           *minimum += child_min;
 320           *natural += child_nat;
 321         }
 322
 323       temp = indicator_size + indicator_spacing * 2;
 324       *minimum = MAX (*minimum, temp) + 2 * (focus_width + focus_pad);
 325       *natural = MAX (*natural, temp) + 2 * (focus_width + focus_pad);
 326     }
 327   else
 328     GTK_WIDGET_CLASS (gtk_check_button_parent_class)->get_preferred_height (widget, minimum, natural);
 329 }
 330
 331 static void
 332 gtk_check_button_size_allocate (GtkWidget     *widget,
 333                                 GtkAllocation *allocation)
 334 {
 335   GtkCheckButton *check_button;
 336   GtkToggleButton *toggle_button;
 337   GtkButton *button;
 338   GtkAllocation child_allocation;
 339
 340   button = GTK_BUTTON (widget);
 341   check_button = GTK_CHECK_BUTTON (widget);
 342   toggle_button = GTK_TOGGLE_BUTTON (widget);
 343
 344   if (gtk_toggle_button_get_mode (toggle_button))
 345     {
 346       GtkWidget *child;
 347       gint indicator_size;
 348       gint indicator_spacing;
 349       gint focus_width;
 350       gint focus_pad;
 351
 352       _gtk_check_button_get_props (check_button, &indicator_size, &indicator_spacing);
 353       gtk_widget_style_get (widget,
 354                             "focus-line-width", &focus_width,
 355                             "focus-padding", &focus_pad,
 356                             NULL);
 357
 358       gtk_widget_set_allocation (widget, allocation);
 359
 360       if (gtk_widget_get_realized (widget))
 361         gdk_window_move_resize (gtk_button_get_event_window (button),
 362                                 allocation->x, allocation->y,
 363                                 allocation->width, allocation->height);
 364
 365       child = gtk_bin_get_child (GTK_BIN (button));
 366       if (child && gtk_widget_get_visible (child))
 367         {
 368           guint border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
 369
 370           child_allocation.width = allocation->width -
 371             ((border_width + focus_width + focus_pad) * 2 + indicator_size + indicator_spacing * 3);
 372           child_allocation.width = MAX (child_allocation.width, 1);
 373
 374           child_allocation.height = allocation->height - (border_width + focus_width + focus_pad) * 2;
 375           child_allocation.height = MAX (child_allocation.height, 1);
 376
 377           child_allocation.x = (border_width + indicator_size + indicator_spacing * 3 +
 378                                 allocation->x + focus_width + focus_pad);
 379           child_allocation.y = allocation->y + (allocation->height - child_allocation.height) / 2;
 380
 381           if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
 382             child_allocation.x = allocation->x + allocation->width
 383               - (child_allocation.x - allocation->x + child_allocation.width);
 384
 385           gtk_widget_size_allocate (child, &child_allocation);
 386         }
 387     }
 388   else
 389     GTK_WIDGET_CLASS (gtk_check_button_parent_class)->size_allocate (widget, allocation);
 390 }
 391
 392 static gint
 393 gtk_check_button_draw (GtkWidget *widget,
 394                        cairo_t   *cr)
 395 {
 396   GtkToggleButton *toggle_button;
 397   GtkBin *bin;
 398   GtkWidget *child;
 399
 400   toggle_button = GTK_TOGGLE_BUTTON (widget);
 401   bin = GTK_BIN (widget);
 402
 403   if (gtk_toggle_button_get_mode (toggle_button))
 404     {
 405       gtk_check_button_paint (widget, cr);
 406
 407       child = gtk_bin_get_child (bin);
 408       if (child)
 409         gtk_container_propagate_draw (GTK_CONTAINER (widget),
 410                                       child,
 411                                       cr);
 412     }
 413   else if (GTK_WIDGET_CLASS (gtk_check_button_parent_class)->draw)
 414     GTK_WIDGET_CLASS (gtk_check_button_parent_class)->draw (widget, cr);
 415
 416   return FALSE;
 417 }
 418
 419
 420 static void
 421 gtk_check_button_draw_indicator (GtkCheckButton *check_button,
 422                                  cairo_t        *cr)
 423 {
 424   GtkCheckButtonClass *class = GTK_CHECK_BUTTON_GET_CLASS (check_button);
 425
 426   if (class->draw_indicator)
 427     class->draw_indicator (check_button, cr);
 428 }
 429
 430 static void
 431 gtk_real_check_button_draw_indicator (GtkCheckButton *check_button,
 432                                       cairo_t        *cr)
 433 {
 434   GtkWidget *widget;
 435   GtkWidget *child;
 436   GtkButton *button;
 437   GtkToggleButton *toggle_button;
 438   GtkStateFlags state = 0;
 439   gint x, y;
 440   gint indicator_size;
 441   gint indicator_spacing;
 442   gint focus_width;
 443   gint focus_pad;
 444   guint border_width;
 445   gboolean interior_focus;
 446   GtkAllocation allocation;
 447   GtkStyleContext *context;
 448
 449   widget = GTK_WIDGET (check_button);
 450   button = GTK_BUTTON (check_button);
 451   toggle_button = GTK_TOGGLE_BUTTON (check_button);
 452
 453   gtk_widget_get_allocation (widget, &allocation);
 454   context = gtk_widget_get_style_context (widget);
 455
 456   gtk_widget_style_get (widget,
 457                         "interior-focus", &interior_focus,
 458                         "focus-line-width", &focus_width,
 459                         "focus-padding", &focus_pad,
 460                         NULL);
 461
 462   _gtk_check_button_get_props (check_button, &indicator_size, &indicator_spacing);
 463
 464   border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
 465
 466   x = indicator_spacing + border_width;
 467   y = (allocation.height - indicator_size) / 2;
 468
 469   child = gtk_bin_get_child (GTK_BIN (check_button));
 470   if (!interior_focus || !(child && gtk_widget_get_visible (child)))
 471     x += focus_width + focus_pad;
 472
 473   if (gtk_toggle_button_get_inconsistent (toggle_button))
 474     state |= GTK_STATE_FLAG_INCONSISTENT;
 475   else if (gtk_toggle_button_get_active (toggle_button) ||
 476            (button->priv->button_down && button->priv->in_button))
 477     state |= GTK_STATE_FLAG_ACTIVE;
 478
 479   if (button->priv->activate_timeout || (button->priv->button_down && button->priv->in_button))
 480     state |= GTK_STATE_FLAG_SELECTED;
 481
 482   if (button->priv->in_button)
 483     state |= GTK_STATE_FLAG_PRELIGHT;
 484   else if (!gtk_widget_is_sensitive (widget))
 485     state |= GTK_STATE_FLAG_INSENSITIVE;
 486
 487   if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
 488     x = allocation.width - (indicator_size + x);
 489
 490   gtk_style_context_set_state (context, state);
 491
 492   if (state & GTK_STATE_FLAG_PRELIGHT)
 493     gtk_render_background (context, cr,
 494                            border_width, border_width,
 495                            allocation.width - (2 * border_width),
 496                            allocation.height - (2 * border_width));
 497
 498   gtk_style_context_save (context);
 499   gtk_style_context_add_class (context, GTK_STYLE_CLASS_CHECK);
 500
 501   gtk_render_check (context, cr,
 502                     x, y, indicator_size, indicator_size);
 503
 504   gtk_style_context_restore (context);
 505 }