gtkseparator.c 9.14 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GTK - The GIMP Toolkit
Elliot Lee's avatar
Elliot Lee committed
2 3 4
 * 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
Javier Jardón's avatar
Javier Jardón committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
Elliot Lee's avatar
Elliot Lee committed
16
 */
17 18

/*
19
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
20 21
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
22
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 24
 */

25
#include "config.h"
26

27
#include "gtkorientableprivate.h"
Elliot Lee's avatar
Elliot Lee committed
28
#include "gtkseparator.h"
29
#include "gtkprivate.h"
30
#include "gtkintl.h"
Elliot Lee's avatar
Elliot Lee committed
31

32 33
/**
 * SECTION:gtkseparator
34
 * @Short_description: A separator widget
35 36
 * @Title: GtkSeparator
 *
37
 * GtkSeparator is a horizontal or vertical separator widget, depending on the 
38
 * value of the #GtkOrientable:orientation property, used to group the widgets within a
39 40
 * window. It displays a line with a shadow to make it appear sunken into the 
 * interface.
41 42 43
 */


44
struct _GtkSeparatorPrivate
45 46 47 48 49
{
  GtkOrientation orientation;
};


50 51 52 53
enum {
  PROP_0,
  PROP_ORIENTATION
};
54 55 56 57 58 59 60 61 62

static void       gtk_separator_set_property (GObject        *object,
                                              guint           prop_id,
                                              const GValue   *value,
                                              GParamSpec     *pspec);
static void       gtk_separator_get_property (GObject        *object,
                                              guint           prop_id,
                                              GValue         *value,
                                              GParamSpec     *pspec);
63 64 65 66 67 68 69 70
static void       gtk_separator_get_preferred_width
                                             (GtkWidget      *widget,
                                              gint           *minimum,
                                              gint           *natural);
static void       gtk_separator_get_preferred_height
                                             (GtkWidget      *widget,
                                              gint           *minimum,
                                              gint           *natural);
71 72
static gboolean   gtk_separator_draw         (GtkWidget      *widget,
                                              cairo_t        *cr);
73 74


75 76 77
G_DEFINE_TYPE_WITH_CODE (GtkSeparator, gtk_separator, GTK_TYPE_WIDGET,
                         G_IMPLEMENT_INTERFACE (GTK_TYPE_ORIENTABLE,
                                                NULL))
78

Elliot Lee's avatar
Elliot Lee committed
79 80 81 82

static void
gtk_separator_class_init (GtkSeparatorClass *class)
{
83 84 85 86 87 88
  GObjectClass *object_class = G_OBJECT_CLASS (class);
  GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);

  object_class->set_property = gtk_separator_set_property;
  object_class->get_property = gtk_separator_get_property;

89 90 91
  widget_class->get_preferred_width = gtk_separator_get_preferred_width;
  widget_class->get_preferred_height = gtk_separator_get_preferred_height;

Matthias Clasen's avatar
Matthias Clasen committed
92
  widget_class->draw = gtk_separator_draw;
93 94

  gtk_widget_class_set_accessible_role (widget_class, ATK_ROLE_SEPARATOR);
95

96
  g_object_class_override_property (object_class, PROP_ORIENTATION, "orientation");
97

98
  g_type_class_add_private (object_class, sizeof (GtkSeparatorPrivate));
Elliot Lee's avatar
Elliot Lee committed
99 100 101 102 103
}

static void
gtk_separator_init (GtkSeparator *separator)
{
104
  GtkSeparatorPrivate *private;
105
  GtkStyleContext *context;
106 107 108

  separator->priv = G_TYPE_INSTANCE_GET_PRIVATE (separator,
                                                 GTK_TYPE_SEPARATOR,
109
                                                 GtkSeparatorPrivate);
110
  private = separator->priv;
111

112
  gtk_widget_set_has_window (GTK_WIDGET (separator), FALSE);
113 114

  private->orientation = GTK_ORIENTATION_HORIZONTAL;
115 116 117

  context = gtk_widget_get_style_context (GTK_WIDGET (separator));
  gtk_style_context_add_class (context, GTK_STYLE_CLASS_SEPARATOR);
118 119 120 121 122 123 124 125
}

static void
gtk_separator_set_property (GObject      *object,
                            guint         prop_id,
                            const GValue *value,
                            GParamSpec   *pspec)
{
126
  GtkSeparator *separator = GTK_SEPARATOR (object);
127
  GtkSeparatorPrivate *private = separator->priv;
128 129 130 131 132

  switch (prop_id)
    {
    case PROP_ORIENTATION:
      private->orientation = g_value_get_enum (value);
133
      _gtk_orientable_set_style_classes (GTK_ORIENTABLE (object));
134 135 136 137 138 139 140 141 142 143 144 145 146 147
      gtk_widget_queue_resize (GTK_WIDGET (object));
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

static void
gtk_separator_get_property (GObject    *object,
                            guint       prop_id,
                            GValue     *value,
                            GParamSpec *pspec)
{
148
  GtkSeparator *separator = GTK_SEPARATOR (object);
149
  GtkSeparatorPrivate *private = separator->priv;
150 151 152 153 154 155 156 157 158 159 160 161 162

  switch (prop_id)
    {
    case PROP_ORIENTATION:
      g_value_set_enum (value, private->orientation);
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

static void
163 164 165 166
gtk_separator_get_preferred_size (GtkWidget      *widget,
                                  GtkOrientation  orientation,
                                  gint           *minimum,
                                  gint           *natural)
167
{
168
  GtkSeparator *separator = GTK_SEPARATOR (widget);
169
  GtkSeparatorPrivate *private = separator->priv;
170 171 172
  GtkStyleContext *context;
  GtkStateFlags state;
  GtkBorder border;
173 174 175
  gboolean wide_sep;
  gint     sep_width;
  gint     sep_height;
176

177 178 179 180
  context = gtk_widget_get_style_context (widget);
  state = gtk_widget_get_state_flags (widget);
  gtk_style_context_get_border (context, state, &border);

181
  gtk_widget_style_get (widget,
182 183 184
                        "wide-separators",  &wide_sep,
                        "separator-width",  &sep_width,
                        "separator-height", &sep_height,
185 186
                        NULL);

187
  if (orientation == private->orientation)
188
    {
189 190 191 192
      *minimum = *natural = 1;
    }
  else if (orientation == GTK_ORIENTATION_VERTICAL)
    {
193
      *minimum = *natural = wide_sep ? sep_height : border.top;
194 195 196
    }
  else
    {
197
      *minimum = *natural = wide_sep ? sep_width : border.left;
198 199 200
    }
}

201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216
static void
gtk_separator_get_preferred_width (GtkWidget *widget,
                                   gint      *minimum,
                                   gint      *natural)
{
  gtk_separator_get_preferred_size (widget, GTK_ORIENTATION_HORIZONTAL, minimum, natural);
}

static void
gtk_separator_get_preferred_height (GtkWidget *widget,
                                    gint      *minimum,
                                    gint      *natural)
{
  gtk_separator_get_preferred_size (widget, GTK_ORIENTATION_VERTICAL, minimum, natural);
}

217
static gboolean
218 219
gtk_separator_draw (GtkWidget *widget,
                    cairo_t   *cr)
220
{
221
  GtkSeparator *separator = GTK_SEPARATOR (widget);
222
  GtkSeparatorPrivate *private = separator->priv;
223 224 225
  GtkStateFlags state;
  GtkStyleContext *context;
  GtkBorder padding;
226
  gboolean wide_separators;
227 228 229
  gint separator_width;
  gint separator_height;
  int width, height;
230

231
  context = gtk_widget_get_style_context (widget);
232 233 234 235 236 237
  gtk_widget_style_get (widget,
                        "wide-separators",  &wide_separators,
                        "separator-width",  &separator_width,
                        "separator-height", &separator_height,
                        NULL);

238
  state = gtk_widget_get_state_flags (widget);
239 240
  width = gtk_widget_get_allocated_width (widget);
  height = gtk_widget_get_allocated_height (widget);
241

242 243
  gtk_style_context_get_padding (context, state, &padding);

244 245 246
  if (private->orientation == GTK_ORIENTATION_HORIZONTAL)
    {
      if (wide_separators)
247 248 249
        gtk_render_frame (context, cr,
                          0, (height - separator_height) / 2,
                          width, separator_height);
250
      else
251 252 253
        gtk_render_line (context, cr,
                         0, (height - padding.top) / 2,
                         width - 1, (height - padding.top) / 2);
254 255 256 257
    }
  else
    {
      if (wide_separators)
258 259 260
        gtk_render_frame (context, cr,
                          (width - separator_width) / 2, 0,
                          separator_width, height);
261
      else
262 263 264
        gtk_render_line (context, cr,
                         (width - padding.left) / 2, 0,
                         (width - padding.left) / 2, height - 1);
265 266 267 268 269 270 271 272 273 274 275 276 277
    }

  return FALSE;
}

/**
 * gtk_separator_new:
 * @orientation: the separator's orientation.
 *
 * Creates a new #GtkSeparator with the given orientation.
 *
 * Return value: a new #GtkSeparator.
 *
278
 * Since: 3.0
279
 */
280 281 282 283 284 285
GtkWidget *
gtk_separator_new (GtkOrientation orientation)
{
  return g_object_new (GTK_TYPE_SEPARATOR,
                       "orientation", orientation,
                       NULL);
Elliot Lee's avatar
Elliot Lee committed
286
}