gtkexpander.c 54 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GTK - The GIMP Toolkit
2 3 4 5 6 7 8 9 10 11 12 13 14 15
 *
 * Copyright (C) 2003 Sun Microsystems, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library 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.
 *
 * You should have received a copy of the GNU Library General Public
Javier Jardón's avatar
Javier Jardón committed
16
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
17 18
 *
 * Authors:
19 20 21 22 23 24 25 26 27 28
 *      Mark McLoughlin <mark@skynet.ie>
 */

/**
 * SECTION:gtkexpander
 * @Short_description: A container which can hide its child
 * @Title: GtkExpander
 *
 * A #GtkExpander allows the user to hide or show its child by clicking
 * on an expander triangle similar to the triangles used in a #GtkTreeView.
29
 *
30 31 32 33
 * Normally you use an expander as you would use any other descendant
 * of #GtkBin; you create the child widget and use gtk_container_add()
 * to add it to the expander. When the expander is toggled, it will take
 * care of showing and hiding the child automatically.
34
 *
35
 * # Special Usage
Matthias Clasen's avatar
Matthias Clasen committed
36
 *
37 38 39 40 41 42 43
 * There are situations in which you may prefer to show and hide the
 * expanded widget yourself, such as when you want to actually create
 * the widget at expansion time. In this case, create a #GtkExpander
 * but do not add a child to it. The expander widget has an
 * #GtkExpander:expanded property which can be used to monitor
 * its expansion state. You should watch this property with a signal
 * connection as follows:
Matthias Clasen's avatar
Matthias Clasen committed
44
 *
45
 * |[<!-- language="C" -->
46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
 * expander = gtk_expander_new_with_mnemonic ("_More Options");
 * g_signal_connect (expander, "notify::expanded",
 *                   G_CALLBACK (expander_callback), NULL);
 *
 * ...
 *
 * static void
 * expander_callback (GObject    *object,
 *                    GParamSpec *param_spec,
 *                    gpointer    user_data)
 * {
 *   GtkExpander *expander;
 *
 *   expander = GTK_EXPANDER (object);
 *
 *   if (gtk_expander_get_expanded (expander))
 *     {
63
 *       // Show or create widgets
64 65 66
 *     }
 *   else
 *     {
67
 *       // Hide or destroy widgets
68 69
 *     }
 * }
70
 * ]|
Matthias Clasen's avatar
Matthias Clasen committed
71
 *
72
 * # GtkExpander as GtkBuildable
Matthias Clasen's avatar
Matthias Clasen committed
73
 *
74 75 76 77
 * The GtkExpander implementation of the GtkBuildable interface supports
 * placing a child in the label position by specifying “label” as the
 * “type” attribute of a <child> element. A normal content child can be
 * specified without specifying a <child> type attribute.
Matthias Clasen's avatar
Matthias Clasen committed
78 79
 *
 * An example of a UI definition fragment with GtkExpander:
80
 * |[
81 82 83 84 85 86 87 88
 * <object class="GtkExpander">
 *   <child type="label">
 *     <object class="GtkLabel" id="expander-label"/>
 *   </child>
 *   <child>
 *     <object class="GtkEntry" id="expander-content"/>
 *   </child>
 * </object>
89
 * ]|
90 91 92 93 94
 *
 * # CSS nodes
 *
 * |[<!-- language="plain" -->
 * expander
95 96
 * ├── title
 * │   ├── arrow
97 98
 * │   ╰── <label widget>
 * ╰── <child>
99 100
 * ]|
 *
101 102 103
 * GtkExpander has three CSS nodes, the main node with the name expander,
 * a subnode with name title and node below it with name arrow. Neither of
 * them is using any style classes.
104 105
 */

106
#include "config.h"
107

Johan Dahlin's avatar
Johan Dahlin committed
108
#include <string.h>
109

110 111 112
#include "gtkexpander.h"

#include "gtklabel.h"
Johan Dahlin's avatar
Johan Dahlin committed
113
#include "gtkbuildable.h"
114 115 116 117 118
#include "gtkcontainer.h"
#include "gtkmarshalers.h"
#include "gtkmain.h"
#include "gtkintl.h"
#include "gtkprivate.h"
119
#include "gtkdnd.h"
120
#include "a11y/gtkexpanderaccessible.h"
121
#include "gtkstylecontextprivate.h"
122
#include "gtkcsscustomgadgetprivate.h"
123
#include "gtkboxgadgetprivate.h"
124
#include "gtkbuiltiniconprivate.h"
125
#include "gtkwidgetprivate.h"
126
#include "gtkcontainerprivate.h"
127 128 129 130


#define DEFAULT_EXPANDER_SIZE 10
#define DEFAULT_EXPANDER_SPACING 2
131
#define TIMEOUT_EXPAND 500
132 133 134 135 136 137 138

enum
{
  PROP_0,
  PROP_EXPANDED,
  PROP_LABEL,
  PROP_USE_UNDERLINE,
139
  PROP_USE_MARKUP,
Soeren Sandmann's avatar
Soeren Sandmann committed
140
  PROP_SPACING,
141
  PROP_LABEL_WIDGET,
142 143
  PROP_LABEL_FILL,
  PROP_RESIZE_TOPLEVEL
144 145 146 147 148 149
};

struct _GtkExpanderPrivate
{
  GtkWidget        *label_widget;
  GdkWindow        *event_window;
150

151 152 153
  GtkCssGadget     *gadget;
  GtkCssGadget     *title_gadget;
  GtkCssGadget     *arrow_gadget;
154

155
  GtkGesture       *multipress_gesture;
156 157
  gint              spacing;

158
  guint             expand_timer;
159

160 161 162 163 164
  guint             expanded        : 1;
  guint             use_underline   : 1;
  guint             use_markup      : 1;
  guint             prelight        : 1;
  guint             label_fill      : 1;
165
  guint             resize_toplevel : 1;
166 167 168
};

static void gtk_expander_set_property (GObject          *object,
169 170 171
                                       guint             prop_id,
                                       const GValue     *value,
                                       GParamSpec       *pspec);
172
static void gtk_expander_get_property (GObject          *object,
173 174 175
                                       guint             prop_id,
                                       GValue           *value,
                                       GParamSpec       *pspec);
176

177
static void     gtk_expander_destroy        (GtkWidget        *widget);
178 179 180
static void     gtk_expander_realize        (GtkWidget        *widget);
static void     gtk_expander_unrealize      (GtkWidget        *widget);
static void     gtk_expander_size_allocate  (GtkWidget        *widget,
181
                                             GtkAllocation    *allocation);
182 183
static void     gtk_expander_map            (GtkWidget        *widget);
static void     gtk_expander_unmap          (GtkWidget        *widget);
Benjamin Otte's avatar
Benjamin Otte committed
184
static gboolean gtk_expander_draw           (GtkWidget        *widget,
185
                                             cairo_t          *cr);
186

187
static gboolean gtk_expander_enter_notify   (GtkWidget        *widget,
188
                                             GdkEventCrossing *event);
189
static gboolean gtk_expander_leave_notify   (GtkWidget        *widget,
190
                                             GdkEventCrossing *event);
191
static gboolean gtk_expander_focus          (GtkWidget        *widget,
192
                                             GtkDirectionType  direction);
193
static gboolean gtk_expander_drag_motion    (GtkWidget        *widget,
194 195 196 197
                                             GdkDragContext   *context,
                                             gint              x,
                                             gint              y,
                                             guint             time);
198
static void     gtk_expander_drag_leave     (GtkWidget        *widget,
199 200
                                             GdkDragContext   *context,
                                             guint             time);
201 202

static void gtk_expander_add    (GtkContainer *container,
203
                                 GtkWidget    *widget);
204
static void gtk_expander_remove (GtkContainer *container,
205
                                 GtkWidget    *widget);
206
static void gtk_expander_forall (GtkContainer *container,
207 208 209
                                 gboolean        include_internals,
                                 GtkCallback     callback,
                                 gpointer        callback_data);
210 211 212

static void gtk_expander_activate (GtkExpander *expander);

213

Johan Dahlin's avatar
Johan Dahlin committed
214 215
/* GtkBuildable */
static void gtk_expander_buildable_init           (GtkBuildableIface *iface);
216
static void gtk_expander_buildable_add_child      (GtkBuildable *buildable,
217 218 219
                                                   GtkBuilder   *builder,
                                                   GObject      *child,
                                                   const gchar  *type);
Johan Dahlin's avatar
Johan Dahlin committed
220

221

222 223 224 225 226 227 228 229 230 231 232 233 234 235 236
/* GtkWidget      */
static void  gtk_expander_get_preferred_width             (GtkWidget           *widget,
                                                           gint                *minimum_size,
                                                           gint                *natural_size);
static void  gtk_expander_get_preferred_height            (GtkWidget           *widget,
                                                           gint                *minimum_size,
                                                           gint                *natural_size);
static void  gtk_expander_get_preferred_height_for_width  (GtkWidget           *layout,
                                                           gint                 width,
                                                           gint                *minimum_height,
                                                           gint                *natural_height);
static void  gtk_expander_get_preferred_width_for_height  (GtkWidget           *layout,
                                                           gint                 width,
                                                           gint                *minimum_height,
                                                           gint                *natural_height);
237 238 239 240
static void gtk_expander_state_flags_changed (GtkWidget        *widget,
                                              GtkStateFlags     previous_state);
static void gtk_expander_direction_changed   (GtkWidget        *widget,
                                              GtkTextDirection  previous_direction);
241

242 243 244 245 246 247 248
/* Gestures */
static void     gesture_multipress_released_cb (GtkGestureMultiPress *gesture,
                                                gint                  n_press,
                                                gdouble               x,
                                                gdouble               y,
                                                GtkExpander          *expander);

Johan Dahlin's avatar
Johan Dahlin committed
249
G_DEFINE_TYPE_WITH_CODE (GtkExpander, gtk_expander, GTK_TYPE_BIN,
250
                         G_ADD_PRIVATE (GtkExpander)
251 252
                         G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
                                                gtk_expander_buildable_init))
253 254 255 256 257 258 259 260 261 262 263 264 265 266 267

static void
gtk_expander_class_init (GtkExpanderClass *klass)
{
  GObjectClass *gobject_class;
  GtkWidgetClass *widget_class;
  GtkContainerClass *container_class;

  gobject_class   = (GObjectClass *) klass;
  widget_class    = (GtkWidgetClass *) klass;
  container_class = (GtkContainerClass *) klass;

  gobject_class->set_property = gtk_expander_set_property;
  gobject_class->get_property = gtk_expander_get_property;

268
  widget_class->destroy              = gtk_expander_destroy;
269 270 271 272 273
  widget_class->realize              = gtk_expander_realize;
  widget_class->unrealize            = gtk_expander_unrealize;
  widget_class->size_allocate        = gtk_expander_size_allocate;
  widget_class->map                  = gtk_expander_map;
  widget_class->unmap                = gtk_expander_unmap;
Benjamin Otte's avatar
Benjamin Otte committed
274
  widget_class->draw                 = gtk_expander_draw;
275 276 277
  widget_class->enter_notify_event   = gtk_expander_enter_notify;
  widget_class->leave_notify_event   = gtk_expander_leave_notify;
  widget_class->focus                = gtk_expander_focus;
278 279
  widget_class->drag_motion          = gtk_expander_drag_motion;
  widget_class->drag_leave           = gtk_expander_drag_leave;
280 281 282 283
  widget_class->get_preferred_width            = gtk_expander_get_preferred_width;
  widget_class->get_preferred_height           = gtk_expander_get_preferred_height;
  widget_class->get_preferred_height_for_width = gtk_expander_get_preferred_height_for_width;
  widget_class->get_preferred_width_for_height = gtk_expander_get_preferred_width_for_height;
284 285
  widget_class->state_flags_changed  = gtk_expander_state_flags_changed;
  widget_class->direction_changed  = gtk_expander_direction_changed;
286 287 288 289 290 291 292 293

  container_class->add    = gtk_expander_add;
  container_class->remove = gtk_expander_remove;
  container_class->forall = gtk_expander_forall;

  klass->activate = gtk_expander_activate;

  g_object_class_install_property (gobject_class,
294 295 296 297 298
                                   PROP_EXPANDED,
                                   g_param_spec_boolean ("expanded",
                                                         P_("Expanded"),
                                                         P_("Whether the expander has been opened to reveal the child widget"),
                                                         FALSE,
299
                                                         GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY));
300 301

  g_object_class_install_property (gobject_class,
302 303 304 305 306
                                   PROP_LABEL,
                                   g_param_spec_string ("label",
                                                        P_("Label"),
                                                        P_("Text of the expander's label"),
                                                        NULL,
307
                                                        GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT));
308 309

  g_object_class_install_property (gobject_class,
310 311 312 313 314
                                   PROP_USE_UNDERLINE,
                                   g_param_spec_boolean ("use-underline",
                                                         P_("Use underline"),
                                                         P_("If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key"),
                                                         FALSE,
315
                                                         GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY));
316

317
  g_object_class_install_property (gobject_class,
318 319 320 321 322
                                   PROP_USE_MARKUP,
                                   g_param_spec_boolean ("use-markup",
                                                         P_("Use markup"),
                                                         P_("The text of the label includes XML markup. See pango_parse_markup()"),
                                                         FALSE,
323
                                                         GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY));
324

325 326 327 328 329 330 331 332 333
  /**
   * GtkExpander:spacing:
   *
   * Space to put between the label and the child when the
   * expander is expanded.
   *
   * Deprecated: 3.20: This property is deprecated and ignored.
   *     Use margins on the child instead.
   */
334
  g_object_class_install_property (gobject_class,
335 336 337 338 339 340 341
                                   PROP_SPACING,
                                   g_param_spec_int ("spacing",
                                                     P_("Spacing"),
                                                     P_("Space to put between the label and the child"),
                                                     0,
                                                     G_MAXINT,
                                                     0,
342
                                                     GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY|G_PARAM_DEPRECATED));
343 344

  g_object_class_install_property (gobject_class,
345 346 347 348 349 350
                                   PROP_LABEL_WIDGET,
                                   g_param_spec_object ("label-widget",
                                                        P_("Label widget"),
                                                        P_("A widget to display in place of the usual expander label"),
                                                        GTK_TYPE_WIDGET,
                                                        GTK_PARAM_READWRITE));
351

352
  g_object_class_install_property (gobject_class,
353 354 355 356 357
                                   PROP_LABEL_FILL,
                                   g_param_spec_boolean ("label-fill",
                                                         P_("Label fill"),
                                                         P_("Whether the label widget should fill all available horizontal space"),
                                                         FALSE,
358
                                                         GTK_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_EXPLICIT_NOTIFY));
359

360 361 362 363 364 365 366 367 368 369 370
  /**
   * GtkExpander:resize-toplevel:
   *
   * When this property is %TRUE, the expander will resize the toplevel
   * widget containing the expander upon expanding and collapsing.
   *
   * Since: 3.2
   */
  g_object_class_install_property (gobject_class,
                                   PROP_RESIZE_TOPLEVEL,
                                   g_param_spec_boolean ("resize-toplevel",
Rachid BM's avatar
Rachid BM committed
371
                                                         P_("Resize toplevel"),
372 373
                                                         P_("Whether the expander will resize the toplevel window upon expanding and collapsing"),
                                                         FALSE,
374
                                                         GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
375

376 377 378 379 380 381 382
  /**
   * GtkExpander:expander-size:
   *
   * The size of the expander arrow.
   *
   * Deprecated: 3.20: Use CSS min-width and min-height instead.
   */
383
  gtk_widget_class_install_style_property (widget_class,
384 385 386 387 388 389
                                           g_param_spec_int ("expander-size",
                                                             P_("Expander Size"),
                                                             P_("Size of the expander arrow"),
                                                             0,
                                                             G_MAXINT,
                                                             DEFAULT_EXPANDER_SIZE,
390
                                                             GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
391

392 393 394 395 396 397 398 399
  /**
   * GtkExpander:expander-spacing:
   *
   * Spaing around the expander arrow.
   *
   * Deprecated: 3.20: Use CSS margins instead, the value of this
   *    style property is ignored.
   */
400
  gtk_widget_class_install_style_property (widget_class,
401 402 403 404 405 406
                                           g_param_spec_int ("expander-spacing",
                                                             P_("Indicator Spacing"),
                                                             P_("Spacing around expander arrow"),
                                                             0,
                                                             G_MAXINT,
                                                             DEFAULT_EXPANDER_SPACING,
407
                                                             GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
408 409

  widget_class->activate_signal =
Matthias Clasen's avatar
Matthias Clasen committed
410
    g_signal_new (I_("activate"),
411 412 413 414 415 416
                  G_TYPE_FROM_CLASS (gobject_class),
                  G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
                  G_STRUCT_OFFSET (GtkExpanderClass, activate),
                  NULL, NULL,
                  _gtk_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
417 418

  gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_EXPANDER_ACCESSIBLE);
419 420 421
  gtk_widget_class_set_css_name (widget_class, "expander");
}

422 423 424 425
static void
gtk_expander_init (GtkExpander *expander)
{
  GtkExpanderPrivate *priv;
426
  GtkCssNode *widget_node;
427

428
  expander->priv = priv = gtk_expander_get_instance_private (expander);
429

430
  gtk_widget_set_can_focus (GTK_WIDGET (expander), TRUE);
431
  gtk_widget_set_has_window (GTK_WIDGET (expander), FALSE);
432 433 434 435 436 437 438

  priv->label_widget = NULL;
  priv->event_window = NULL;
  priv->spacing = 0;

  priv->expanded = FALSE;
  priv->use_underline = FALSE;
439
  priv->use_markup = FALSE;
440
  priv->prelight = FALSE;
441
  priv->label_fill = FALSE;
442
  priv->expand_timer = 0;
443
  priv->resize_toplevel = 0;
444

445
  widget_node = gtk_widget_get_css_node (GTK_WIDGET (expander));
446 447 448 449 450 451 452
  priv->gadget = gtk_box_gadget_new_for_node (widget_node, GTK_WIDGET (expander));
  gtk_box_gadget_set_orientation (GTK_BOX_GADGET (priv->gadget), GTK_ORIENTATION_VERTICAL);
  priv->title_gadget = gtk_box_gadget_new ("title",
                                           GTK_WIDGET (expander),
                                           priv->gadget,
                                           NULL);
  gtk_box_gadget_set_orientation (GTK_BOX_GADGET (priv->title_gadget), GTK_ORIENTATION_HORIZONTAL);
Matthias Clasen's avatar
Matthias Clasen committed
453
  gtk_box_gadget_set_draw_focus (GTK_BOX_GADGET (priv->title_gadget), TRUE);
454
  gtk_box_gadget_insert_gadget (GTK_BOX_GADGET (priv->gadget), -1, priv->title_gadget, FALSE, FALSE, GTK_ALIGN_START);
455

456 457 458 459 460 461
  priv->arrow_gadget = gtk_builtin_icon_new ("arrow",
                                             GTK_WIDGET (expander),
                                             priv->title_gadget,
                                             NULL);
  gtk_css_gadget_add_class (priv->arrow_gadget, GTK_STYLE_CLASS_HORIZONTAL);
  gtk_builtin_icon_set_default_size_property (GTK_BUILTIN_ICON (priv->arrow_gadget), "expander-size");
462

463 464
  gtk_box_gadget_insert_gadget (GTK_BOX_GADGET (priv->title_gadget), -1, priv->arrow_gadget, FALSE, FALSE, GTK_ALIGN_CENTER);

465 466
  gtk_drag_dest_set (GTK_WIDGET (expander), 0, NULL, 0, 0);
  gtk_drag_dest_set_track_motion (GTK_WIDGET (expander), TRUE);
467 468 469 470 471 472 473 474 475 476

  priv->multipress_gesture = gtk_gesture_multi_press_new (GTK_WIDGET (expander));
  gtk_gesture_single_set_button (GTK_GESTURE_SINGLE (priv->multipress_gesture),
                                 GDK_BUTTON_PRIMARY);
  gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (priv->multipress_gesture),
                                     FALSE);
  g_signal_connect (priv->multipress_gesture, "released",
                    G_CALLBACK (gesture_multipress_released_cb), expander);
  gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->multipress_gesture),
                                              GTK_PHASE_BUBBLE);
477 478
}

Johan Dahlin's avatar
Johan Dahlin committed
479
static void
480
gtk_expander_buildable_add_child (GtkBuildable  *buildable,
481 482 483
                                  GtkBuilder    *builder,
                                  GObject       *child,
                                  const gchar   *type)
Johan Dahlin's avatar
Johan Dahlin committed
484 485 486 487 488 489 490 491 492 493 494 495
{
  if (!type)
    gtk_container_add (GTK_CONTAINER (buildable), GTK_WIDGET (child));
  else if (strcmp (type, "label") == 0)
    gtk_expander_set_label_widget (GTK_EXPANDER (buildable), GTK_WIDGET (child));
  else
    GTK_BUILDER_WARN_INVALID_CHILD_TYPE (GTK_EXPANDER (buildable), type);
}

static void
gtk_expander_buildable_init (GtkBuildableIface *iface)
{
496
  iface->add_child = gtk_expander_buildable_add_child;
Johan Dahlin's avatar
Johan Dahlin committed
497 498
}

499 500
static void
gtk_expander_set_property (GObject      *object,
501 502 503
                           guint         prop_id,
                           const GValue *value,
                           GParamSpec   *pspec)
504 505
{
  GtkExpander *expander = GTK_EXPANDER (object);
506

507 508 509 510 511 512 513 514 515 516 517
  switch (prop_id)
    {
    case PROP_EXPANDED:
      gtk_expander_set_expanded (expander, g_value_get_boolean (value));
      break;
    case PROP_LABEL:
      gtk_expander_set_label (expander, g_value_get_string (value));
      break;
    case PROP_USE_UNDERLINE:
      gtk_expander_set_use_underline (expander, g_value_get_boolean (value));
      break;
518 519 520
    case PROP_USE_MARKUP:
      gtk_expander_set_use_markup (expander, g_value_get_boolean (value));
      break;
Soeren Sandmann's avatar
Soeren Sandmann committed
521
    case PROP_SPACING:
522 523 524 525 526
      gtk_expander_set_spacing (expander, g_value_get_int (value));
      break;
    case PROP_LABEL_WIDGET:
      gtk_expander_set_label_widget (expander, g_value_get_object (value));
      break;
527 528 529
    case PROP_LABEL_FILL:
      gtk_expander_set_label_fill (expander, g_value_get_boolean (value));
      break;
530 531 532
    case PROP_RESIZE_TOPLEVEL:
      gtk_expander_set_resize_toplevel (expander, g_value_get_boolean (value));
      break;
533 534 535 536 537 538 539 540
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

static void
gtk_expander_get_property (GObject    *object,
541 542 543
                           guint       prop_id,
                           GValue     *value,
                           GParamSpec *pspec)
544 545 546 547 548 549 550 551 552 553 554 555 556 557 558
{
  GtkExpander *expander = GTK_EXPANDER (object);
  GtkExpanderPrivate *priv = expander->priv;

  switch (prop_id)
    {
    case PROP_EXPANDED:
      g_value_set_boolean (value, priv->expanded);
      break;
    case PROP_LABEL:
      g_value_set_string (value, gtk_expander_get_label (expander));
      break;
    case PROP_USE_UNDERLINE:
      g_value_set_boolean (value, priv->use_underline);
      break;
559 560 561
    case PROP_USE_MARKUP:
      g_value_set_boolean (value, priv->use_markup);
      break;
Soeren Sandmann's avatar
Soeren Sandmann committed
562
    case PROP_SPACING:
563 564 565 566
      g_value_set_int (value, priv->spacing);
      break;
    case PROP_LABEL_WIDGET:
      g_value_set_object (value,
567 568
                          priv->label_widget ?
                          G_OBJECT (priv->label_widget) : NULL);
569
      break;
570 571 572
    case PROP_LABEL_FILL:
      g_value_set_boolean (value, priv->label_fill);
      break;
573 574 575
    case PROP_RESIZE_TOPLEVEL:
      g_value_set_boolean (value, gtk_expander_get_resize_toplevel (expander));
      break;
576 577 578 579 580 581
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

582
static void
583
gtk_expander_destroy (GtkWidget *widget)
584
{
585 586
  GtkExpanderPrivate *priv = GTK_EXPANDER (widget)->priv;

587
  if (priv->expand_timer)
588
    {
589 590
      g_source_remove (priv->expand_timer);
      priv->expand_timer = 0;
591
    }
592

593 594
  g_clear_object (&priv->multipress_gesture);

595 596
  GTK_WIDGET_CLASS (gtk_expander_parent_class)->destroy (widget);

597 598 599
  g_clear_object (&priv->arrow_gadget);
  g_clear_object (&priv->title_gadget);
  g_clear_object (&priv->gadget);
600 601 602 603 604 605 606 607 608 609 610 611
}

static void
gtk_expander_realize (GtkWidget *widget)
{
  GtkAllocation allocation;
  GtkExpanderPrivate *priv;
  GdkWindow *window;
  GdkWindowAttr attributes;
  gint attributes_mask;

  priv = GTK_EXPANDER (widget)->priv;
612

613 614
  gtk_widget_get_allocation (widget, &allocation);

615
  attributes.window_type = GDK_WINDOW_CHILD;
616 617 618 619
  attributes.x = allocation.x;
  attributes.y = allocation.y;
  attributes.width = allocation.width;
  attributes.height = allocation.height;
620
  attributes.wclass = GDK_INPUT_ONLY;
621 622 623 624 625
  attributes.event_mask = gtk_widget_get_events (widget)
                          | GDK_BUTTON_PRESS_MASK
                          | GDK_BUTTON_RELEASE_MASK
                          | GDK_ENTER_NOTIFY_MASK
                          | GDK_LEAVE_NOTIFY_MASK;
626 627 628

  attributes_mask = GDK_WA_X | GDK_WA_Y;

629 630 631
  window = gtk_widget_get_parent_window (widget);
  gtk_widget_set_window (widget, window);
  g_object_ref (window);
632 633

  priv->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
634
                                       &attributes, attributes_mask);
635
  gtk_widget_register_window (widget, priv->event_window);
636

637
  gtk_gesture_set_window (priv->multipress_gesture, priv->event_window);
638
  gtk_widget_set_realized (widget, TRUE);
639 640 641 642 643 644 645 646 647
}

static void
gtk_expander_unrealize (GtkWidget *widget)
{
  GtkExpanderPrivate *priv = GTK_EXPANDER (widget)->priv;

  if (priv->event_window)
    {
648
      gtk_gesture_set_window (priv->multipress_gesture, NULL);
649
      gtk_widget_unregister_window (widget, priv->event_window);
650 651 652 653
      gdk_window_destroy (priv->event_window);
      priv->event_window = NULL;
    }

Matthias Clasen's avatar
Matthias Clasen committed
654
  GTK_WIDGET_CLASS (gtk_expander_parent_class)->unrealize (widget);
655 656 657 658
}

static void
gtk_expander_size_allocate (GtkWidget     *widget,
659
                            GtkAllocation *allocation)
660
{
661
  GtkExpanderPrivate *priv = GTK_EXPANDER (widget)->priv;
662 663 664 665
  GtkAllocation clip;

  gtk_widget_set_allocation (widget, allocation);

666
  gtk_css_gadget_allocate (priv->gadget,
667 668 669 670 671 672 673
                           allocation,
                           gtk_widget_get_allocated_baseline (widget),
                           &clip);

  gtk_widget_set_clip (widget, &clip);

  if (gtk_widget_get_realized (widget))
674
    {
675
      GtkAllocation title_allocation;
676

677 678 679 680
      gtk_css_gadget_get_border_allocation (priv->title_gadget, &title_allocation, NULL);
      gdk_window_move_resize (priv->event_window,
                              title_allocation.x, title_allocation.y,
                              title_allocation.width, title_allocation.height);
681 682 683 684 685 686 687 688 689 690 691
    }
}

static void
gtk_expander_map (GtkWidget *widget)
{
  GtkExpanderPrivate *priv = GTK_EXPANDER (widget)->priv;

  if (priv->label_widget)
    gtk_widget_map (priv->label_widget);

Matthias Clasen's avatar
Matthias Clasen committed
692
  GTK_WIDGET_CLASS (gtk_expander_parent_class)->map (widget);
693 694 695 696 697 698 699 700 701 702 703 704 705

  if (priv->event_window)
    gdk_window_show (priv->event_window);
}

static void
gtk_expander_unmap (GtkWidget *widget)
{
  GtkExpanderPrivate *priv = GTK_EXPANDER (widget)->priv;

  if (priv->event_window)
    gdk_window_hide (priv->event_window);

Matthias Clasen's avatar
Matthias Clasen committed
706
  GTK_WIDGET_CLASS (gtk_expander_parent_class)->unmap (widget);
707 708 709 710 711 712

  if (priv->label_widget)
    gtk_widget_unmap (priv->label_widget);
}

static gboolean
Benjamin Otte's avatar
Benjamin Otte committed
713
gtk_expander_draw (GtkWidget *widget,
714
                   cairo_t   *cr)
715
{
716 717 718 719 720
  gtk_css_gadget_draw (GTK_EXPANDER (widget)->priv->gadget, cr);

  return FALSE;
}

721
static void
722 723 724 725 726
gesture_multipress_released_cb (GtkGestureMultiPress *gesture,
                                gint                  n_press,
                                gdouble               x,
                                gdouble               y,
                                GtkExpander          *expander)
727
{
728 729
  if (expander->priv->prelight)
    gtk_widget_activate (GTK_WIDGET (expander));
730 731 732 733 734
}

static void
gtk_expander_redraw_expander (GtkExpander *expander)
{
735 736
  GtkAllocation allocation;
  GtkWidget *widget = GTK_WIDGET (expander);
737

738
  if (gtk_widget_get_realized (widget))
739 740 741 742
    {
      gtk_widget_get_allocation (widget, &allocation);
      gdk_window_invalidate_rect (gtk_widget_get_window (widget), &allocation, FALSE);
    }
743 744
}

745
static void
746
update_node_state (GtkExpander *expander)
747 748 749 750 751 752 753 754 755 756 757
{
  GtkExpanderPrivate *priv = expander->priv;
  GtkStateFlags state;

  state = gtk_widget_get_state_flags (GTK_WIDGET (expander));

  if (priv->prelight)
    state |= GTK_STATE_FLAG_PRELIGHT;
  else
    state &= ~GTK_STATE_FLAG_PRELIGHT;

758
  gtk_css_gadget_set_state (priv->title_gadget, state);
759

760 761 762 763 764
  if (priv->expanded)
    state |= GTK_STATE_FLAG_CHECKED;
  else
    state &= ~GTK_STATE_FLAG_CHECKED;

765
  gtk_css_gadget_set_state (priv->arrow_gadget, state);
766 767 768 769 770 771 772 773 774 775 776 777 778 779 780
}

static void
gtk_expander_state_flags_changed (GtkWidget     *widget,
                                  GtkStateFlags  previous_state)
{
  update_node_state (GTK_EXPANDER (widget));

  GTK_WIDGET_CLASS (gtk_expander_parent_class)->state_flags_changed (widget, previous_state);
}

static void
gtk_expander_direction_changed (GtkWidget        *widget,
                                GtkTextDirection  previous_direction)
{
781
  GtkExpanderPrivate *priv = GTK_EXPANDER (widget)->priv;
782
  GtkAlign align;
783 784

  gtk_box_gadget_reverse_children (GTK_BOX_GADGET (priv->title_gadget));
785

786 787 788 789
  align = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL ? GTK_ALIGN_END : GTK_ALIGN_START;
  gtk_box_gadget_remove_gadget (GTK_BOX_GADGET (priv->gadget), priv->title_gadget);
  gtk_box_gadget_insert_gadget (GTK_BOX_GADGET (priv->gadget), 0, priv->title_gadget, FALSE, FALSE, align);

790 791 792
  gtk_box_gadget_set_allocate_reverse (GTK_BOX_GADGET (priv->title_gadget),
                                       gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);

793
  GTK_WIDGET_CLASS (gtk_expander_parent_class)->direction_changed (widget, previous_direction);
794 795
}

796 797
static gboolean
gtk_expander_enter_notify (GtkWidget        *widget,
798
                           GdkEventCrossing *event)
799 800 801
{
  GtkExpander *expander = GTK_EXPANDER (widget);

802
  if (event->window == expander->priv->event_window &&
803 804 805
      event->detail != GDK_NOTIFY_INFERIOR)
    {
      expander->priv->prelight = TRUE;
806

807
      update_node_state (expander);
808

809
      if (expander->priv->label_widget)
810 811 812
        gtk_widget_set_state_flags (expander->priv->label_widget,
                                    GTK_STATE_FLAG_PRELIGHT,
                                    FALSE);
813

814 815 816 817 818 819 820 821
      gtk_expander_redraw_expander (expander);
    }

  return FALSE;
}

static gboolean
gtk_expander_leave_notify (GtkWidget        *widget,
822
                           GdkEventCrossing *event)
823 824 825
{
  GtkExpander *expander = GTK_EXPANDER (widget);

826
  if (event->window == expander->priv->event_window &&
827 828 829
      event->detail != GDK_NOTIFY_INFERIOR)
    {
      expander->priv->prelight = FALSE;
830

831
      update_node_state (expander);
832

833
      if (expander->priv->label_widget)
834 835
        gtk_widget_unset_state_flags (expander->priv->label_widget,
                                      GTK_STATE_FLAG_PRELIGHT);
836

837 838 839 840 841 842
      gtk_expander_redraw_expander (expander);
    }

  return FALSE;
}

843 844 845 846 847 848 849 850 851 852 853 854 855 856
static gboolean
expand_timeout (gpointer data)
{
  GtkExpander *expander = GTK_EXPANDER (data);
  GtkExpanderPrivate *priv = expander->priv;

  priv->expand_timer = 0;
  gtk_expander_set_expanded (expander, TRUE);

  return FALSE;
}

static gboolean
gtk_expander_drag_motion (GtkWidget        *widget,
857 858 859 860
                          GdkDragContext   *context,
                          gint              x,
                          gint              y,
                          guint             time)
861 862 863 864 865 866
{
  GtkExpander *expander = GTK_EXPANDER (widget);
  GtkExpanderPrivate *priv = expander->priv;

  if (!priv->expanded && !priv->expand_timer)
    {
867
      priv->expand_timer = gdk_threads_add_timeout (TIMEOUT_EXPAND, (GSourceFunc) expand_timeout, expander);
Bastien Nocera's avatar
Bastien Nocera committed
868
      g_source_set_name_by_id (priv->expand_timer, "[gtk+] expand_timeout");
869 870 871 872 873 874 875
    }

  return TRUE;
}

static void
gtk_expander_drag_leave (GtkWidget      *widget,
876 877
                         GdkDragContext *context,
                         guint           time)
878 879 880 881 882 883 884 885 886 887 888
{
  GtkExpander *expander = GTK_EXPANDER (widget);
  GtkExpanderPrivate *priv = expander->priv;

  if (priv->expand_timer)
    {
      g_source_remove (priv->expand_timer);
      priv->expand_timer = 0;
    }
}

889 890 891 892 893 894 895 896 897 898
typedef enum
{
  FOCUS_NONE,
  FOCUS_WIDGET,
  FOCUS_LABEL,
  FOCUS_CHILD
} FocusSite;

static gboolean
focus_current_site (GtkExpander      *expander,
899
                    GtkDirectionType  direction)
900 901 902
{
  GtkWidget *current_focus;

903
  current_focus = gtk_container_get_focus_child (GTK_CONTAINER (expander));
904 905 906 907 908 909 910 911 912

  if (!current_focus)
    return FALSE;

  return gtk_widget_child_focus (current_focus, direction);
}

static gboolean
focus_in_site (GtkExpander      *expander,
913 914
               FocusSite         site,
               GtkDirectionType  direction)
915 916 917 918 919 920 921 922
{
  switch (site)
    {
    case FOCUS_WIDGET:
      gtk_widget_grab_focus (GTK_WIDGET (expander));
      return TRUE;
    case FOCUS_LABEL:
      if (expander->priv->label_widget)
923
        return gtk_widget_child_focus (expander->priv->label_widget, direction);
924
      else
925
        return FALSE;
926 927
    case FOCUS_CHILD:
      {
928
        GtkWidget *child = gtk_bin_get_child (GTK_BIN (expander));
929

930 931 932 933
        if (child && gtk_widget_get_child_visible (child))
          return gtk_widget_child_focus (child, direction);
        else
          return FALSE;
934 935 936 937 938 939 940 941 942 943 944
      }
    case FOCUS_NONE:
      break;
    }

  g_assert_not_reached ();
  return FALSE;
}

static FocusSite
get_next_site (GtkExpander      *expander,
945 946
               FocusSite         site,
               GtkDirectionType  direction)
947 948 949 950 951 952 953 954 955
{
  gboolean ltr;

  ltr = gtk_widget_get_direction (GTK_WIDGET (expander)) != GTK_TEXT_DIR_RTL;

  switch (site)
    {
    case FOCUS_NONE:
      switch (direction)
956 957 958 959 960 961 962 963 964 965
        {
        case GTK_DIR_TAB_BACKWARD:
        case GTK_DIR_LEFT:
        case GTK_DIR_UP:
          return FOCUS_CHILD;
        case GTK_DIR_TAB_FORWARD:
        case GTK_DIR_DOWN:
        case GTK_DIR_RIGHT:
          return FOCUS_WIDGET;
        }
966
      break;
967 968
    case FOCUS_WIDGET:
      switch (direction)
969 970 971 972 973 974 975 976 977 978 979 980
        {
        case GTK_DIR_TAB_BACKWARD:
        case GTK_DIR_UP:
          return FOCUS_NONE;
        case GTK_DIR_LEFT:
          return ltr ? FOCUS_NONE : FOCUS_LABEL;
        case GTK_DIR_TAB_FORWARD:
        case GTK_DIR_DOWN:
          return FOCUS_LABEL;
        case GTK_DIR_RIGHT:
          return ltr ? FOCUS_LABEL : FOCUS_NONE;
        }
981
      break;
982 983
    case FOCUS_LABEL:
      switch (direction)
984 985 986 987 988 989 990 991 992 993 994 995
        {
        case GTK_DIR_TAB_BACKWARD:
        case GTK_DIR_UP:
          return FOCUS_WIDGET;
        case GTK_DIR_LEFT:
          return ltr ? FOCUS_WIDGET : FOCUS_CHILD;
        case GTK_DIR_TAB_FORWARD:
        case GTK_DIR_DOWN:
          return FOCUS_CHILD;
        case GTK_DIR_RIGHT:
          return ltr ? FOCUS_CHILD : FOCUS_WIDGET;
        }
996
      break;
997 998
    case FOCUS_CHILD:
      switch (direction)
999 1000 1001 1002 1003 1004 1005 1006 1007 1008
        {
        case GTK_DIR_TAB_BACKWARD:
        case GTK_DIR_LEFT:
        case GTK_DIR_UP:
          return FOCUS_LABEL;
        case GTK_DIR_TAB_FORWARD:
        case GTK_DIR_DOWN:
        case GTK_DIR_RIGHT:
          return FOCUS_NONE;
        }
1009
      break;
1010 1011 1012 1013 1014 1015
    }

  g_assert_not_reached ();
  return FOCUS_NONE;
}

1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029
static void
gtk_expander_resize_toplevel (GtkExpander *expander)
{
  GtkExpanderPrivate *priv = expander->priv;
  GtkWidget *child = gtk_bin_get_child (GTK_BIN (expander));

  if (child && priv->resize_toplevel &&
      gtk_widget_get_realized (GTK_WIDGET (expander)))
    {
      GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (expander));

      if (toplevel && gtk_widget_get_realized (toplevel))
        {
          GtkAllocation toplevel_allocation;
1030
          GtkAllocation child_allocation;
1031 1032

          gtk_widget_get_allocation (toplevel, &toplevel_allocation);
1033
          gtk_widget_get_allocation (child, &child_allocation);
1034 1035 1036 1037 1038

          if (priv->expanded)
            {
              GtkRequisition child_requisition;

1039
              gtk_widget_get_preferred_height_for_width (child, child_allocation.width, &child_requisition.height, NULL);
1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054

              toplevel_allocation.height += child_requisition.height;
            }
          else
            {
              toplevel_allocation.height -= child_allocation.height;
            }

          gtk_window_resize (GTK_WINDOW (toplevel),
                             toplevel_allocation.width,
                             toplevel_allocation.height);
        }
    }
}

1055 1056
static gboolean
gtk_expander_focus (GtkWidget        *widget,
1057
                    GtkDirectionType  direction)
1058 1059
{
  GtkExpander *expander = GTK_EXPANDER (widget);
1060

1061 1062 1063 1064 1065
  if (!focus_current_site (expander, direction))
    {
      GtkWidget *old_focus_child;
      gboolean widget_is_focus;
      FocusSite site = FOCUS_NONE;
1066

1067
      widget_is_focus = gtk_widget_is_focus (widget);
1068
      old_focus_child = gtk_container_get_focus_child (GTK_CONTAINER (widget));
1069

1070
      if (old_focus_child && old_focus_child == expander->priv->label_widget)
1071
        site = FOCUS_LABEL;
1072
      else if (old_focus_child)
1073
        site = FOCUS_CHILD;
1074
      else if (widget_is_focus)
1075
        site = FOCUS_WIDGET;
1076 1077

      while ((site = get_next_site (expander, site, direction)) != FOCUS_NONE)
1078 1079 1080 1081
        {
          if (focus_in_site (expander, site, direction))
            return TRUE;
        }
1082 1083 1084 1085 1086 1087 1088 1089 1090

      return FALSE;
    }

  return TRUE;
}

static void
gtk_expander_add (GtkContainer *container,
1091
                  GtkWidget    *widget)
1092
{
1093 1094
  GtkExpander *expander = GTK_EXPANDER (container);

Matthias Clasen's avatar
Matthias Clasen committed
1095
  GTK_CONTAINER_CLASS (gtk_expander_parent_class)->add (container, widget);
1096 1097

  gtk_widget_queue_resize (GTK_WIDGET (container));
1098 1099 1100

  if (expander->priv->expanded)
    gtk_box_gadget_insert_widget (GTK_BOX_GADGET (expander->priv->gadget), -1, widget);
1101 1102 1103 1104
}

static void
gtk_expander_remove (GtkContainer *container,
1105
                     GtkWidget    *widget)
1106 1107 1108 1109 1110 1111
{
  GtkExpander *expander = GTK_EXPANDER (container);

  if (GTK_EXPANDER (expander)->priv->label_widget == widget)
    gtk_expander_set_label_widget (expander, NULL);
  else
1112 1113 1114 1115
    {
      gtk_box_gadget_remove_widget (GTK_BOX_GADGET (expander->priv->gadget), widget);
      GTK_CONTAINER_CLASS (gtk_expander_parent_class)->remove (container, widget);
    }
1116 1117 1118 1119
}

static void
gtk_expander_forall (GtkContainer *container,
1120 1121 1122
                     gboolean      include_internals,
                     GtkCallback   callback,
                     gpointer      callback_data)
1123 1124 1125
{
  GtkBin *bin = GTK_BIN (container);
  GtkExpanderPrivate *priv = GTK_EXPANDER (container)->priv;
Javier Jardón's avatar
Javier Jardón committed
1126
  GtkWidget *child;
1127

Javier Jardón's avatar
Javier Jardón committed
1128 1129 1130
  child = gtk_bin_get_child (bin);
  if (child)
    (* callback) (child, callback_data);
1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141

  if (priv->label_widget)
    (* callback) (priv->label_widget, callback_data);
}

static void
gtk_expander_activate (GtkExpander *expander)
{
  gtk_expander_set_expanded (expander, !expander->priv->expanded);
}

1142
static void
1143 1144 1145
gtk_expander_get_preferred_width (GtkWidget *widget,
                                  gint      *minimum_size,
                                  gint      *natural_size)
1146
{
1147 1148 1149 1150 1151
  gtk_css_gadget_get_preferred_size (GTK_EXPANDER (widget)->priv->gadget,
                                     GTK_ORIENTATION_HORIZONTAL,
                                     -1,
                                     minimum_size, natural_size,
                                     NULL, NULL);
1152 1153 1154
}

static void
1155 1156 1157
gtk_expander_get_preferred_height (GtkWidget *widget,
                                   gint      *minimum_size,
                                   gint      *natural_size)
1158
{
1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191
  gtk_css_gadget_get_preferred_size (GTK_EXPANDER (widget)->priv->gadget,
                                     GTK_ORIENTATION_VERTICAL,
                                     -1,
                                     minimum_size, natural_size,
                                     NULL, NULL);
}

static void
gtk_expander_get_preferred_width_for_height (GtkWidget *widget,
                                             gint       height,
                                             gint      *minimum_size,
                                             gint      *natural_size)
{
  gtk_css_gadget_get_preferred_size (GTK_EXPANDER (widget)->priv->gadget,
                                     GTK_ORIENTATION_HORIZONTAL,
                                     height,
                                     minimum_size, natural_size,
                                     NULL, NULL);
}

static void
gtk_expander_get_preferred_height_for_width (GtkWidget *widget,
                                             gint       width,
                                             gint      *minimum_size,
                                             gint      *natural_size)
{
  gtk_css_gadget_get_preferred_size (GTK_EXPANDER (widget)->priv->gadget,
                                     GTK_ORIENTATION_VERTICAL,
                                     width,
                                     minimum_size, natural_size,
                                     NULL, NULL);
}

Matthias Clasen's avatar
Matthias Clasen committed
1192 1193 1194
/**
 * gtk_expander_new:
 * @label: the text of the label
1195
 *
Matthias Clasen's avatar
Matthias Clasen committed
1196
 * Creates a new expander using @label as the text of the label.
1197
 *
1198
 * Returns: a new #GtkExpander widget.
Matthias Clasen's avatar
Matthias Clasen committed
1199 1200
 *
 * Since: 2.4
1201
 */
1202 1203 1204 1205 1206 1207
GtkWidget *
gtk_expander_new (const gchar *label)
{
  return g_object_new (GTK_TYPE_EXPANDER, "label", label, NULL);
}

Matthias Clasen's avatar
Matthias Clasen committed
1208 1209
/**
 * gtk_expander_new_with_mnemonic:
1210 1211
 * @label: (allow-none): the text of the label with an underscore
 *     in front of the mnemonic character
1212
 *
Matthias Clasen's avatar
Matthias Clasen committed
1213 1214
 * Creates a new expander using @label as the text of the label.
 * If characters in @label are preceded by an underscore, they are underlined.
1215
 * If you need a literal underscore character in a label, use “__” (two
1216
 * underscores). The first underlined character represents a keyboard
Matthias Clasen's avatar
Matthias Clasen committed
1217 1218
 * accelerator called a mnemonic.
 * Pressing Alt and that key activates the button.
1219
 *
1220
 * Returns: a new #GtkExpander widget.
Matthias Clasen's avatar
Matthias Clasen committed
1221 1222
 *
 * Since: 2.4
1223
 */
1224 1225 1226 1227
GtkWidget *
gtk_expander_new_with_mnemonic (const gchar *label)
{
  return g_object_new (GTK_TYPE_EXPANDER,
1228 1229 1230
                       "label", label,
                       "use-underline", TRUE,
                       NULL);
1231 1232 1233 1234 1235 1236 1237
}

/**
 * gtk_expander_set_expanded:
 * @expander: a #GtkExpander
 * @expanded: whether the child widget is revealed
 *
Matthias Clasen's avatar
Matthias Clasen committed
1238 1239
 * Sets the state of the expander. Set to %TRUE, if you want
 * the child widget to be revealed, and %FALSE if you want the
1240
 * child widget to be hidden.
Matthias Clasen's avatar
Matthias Clasen committed
1241 1242
 *
 * Since: 2.4
1243
 */
1244 1245
void
gtk_expander_set_expanded (GtkExpander *expander,
1246
                           gboolean     expanded)
1247 1248
{
  GtkExpanderPrivate *priv;
Javier Jardón's avatar
Javier Jardón committed
1249
  GtkWidget *child;
1250 1251 1252 1253 1254 1255 1256

  g_return_if_fail (GTK_IS_EXPANDER (expander));

  priv = expander->priv;

  expanded = expanded != FALSE;

1257 1258
  if (priv->expanded == expanded)
    return;
1259

1260
  priv->expanded = expanded;
1261

1262
  update_node_state (expander);
1263

1264
  child = gtk_bin_get_child (GTK_BIN (expander));
1265

1266 1267
  if (child)
    {
1268 1269 1270 1271 1272
      if (priv->expanded)
        gtk_box_gadget_insert_widget (GTK_BOX_GADGET (priv->gadget), 1, child);
      else
        gtk_box_gadget_remove_widget (GTK_BOX_GADGET (priv->gadget), child);

1273 1274
      gtk_widget_queue_resize (GTK_WIDGET (expander));
      gtk_expander_resize_toplevel (expander);
1275
    }