gtkcsscustomproperty.c 9.34 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14
/*
 * Copyright © 2011 Red Hat Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 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
 * Lesser General Public License for more details.
 *
 * 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/>.
16 17 18 19 20 21 22 23 24 25
 *
 * Authors: Benjamin Otte <otte@gnome.org>
 */

#include "config.h"

#include "gtkcsscustompropertyprivate.h"

#include <string.h>

26
#include "gtkcssstylefuncsprivate.h"
27
#include "gtkcsstypedvalueprivate.h"
Matthias Clasen's avatar
Matthias Clasen committed
28
#include "deprecated/gtkstylepropertiesprivate.h"
29 30

#include "deprecated/gtkthemingengine.h"
31

32 33
#include "deprecated/gtksymboliccolor.h"

34 35
G_DEFINE_TYPE (GtkCssCustomProperty, _gtk_css_custom_property, GTK_TYPE_CSS_STYLE_PROPERTY)

36
static GtkCssValue *
37
gtk_css_custom_property_parse_value (GtkStyleProperty *property,
38
                                     GtkCssParser     *parser)
39
{
40 41 42 43
  _gtk_css_parser_error_full (parser,
                              GTK_CSS_PROVIDER_ERROR_NAME,
                              "Custom CSS properties are no longer supported.");
  return NULL;
44 45
}

46 47 48 49 50 51 52
static void
gtk_css_custom_property_query (GtkStyleProperty   *property,
                               GValue             *value,
                               GtkStyleQueryFunc   query_func,
                               gpointer            query_data)
{
  GtkCssStyleProperty *style = GTK_CSS_STYLE_PROPERTY (property);
53
  GtkCssCustomProperty *custom = GTK_CSS_CUSTOM_PROPERTY (property);
54 55 56 57
  GtkCssValue *css_value;
  
  css_value = (* query_func) (_gtk_css_style_property_get_id (style), query_data);
  if (css_value == NULL)
58
    css_value = _gtk_css_style_property_get_initial_value (style);
59

60 61
  g_value_init (value, custom->pspec->value_type);
  g_value_copy (_gtk_css_typed_value_get (css_value), value);
62 63
}

64 65 66 67 68 69
static void
gtk_css_custom_property_assign (GtkStyleProperty   *property,
                                GtkStyleProperties *props,
                                GtkStateFlags       state,
                                const GValue       *value)
{
70
  GtkCssValue *css_value = _gtk_css_typed_value_new (value);
71 72 73 74 75 76 77
  _gtk_style_properties_set_property_by_property (props,
                                                  GTK_CSS_STYLE_PROPERTY (property),
                                                  state,
                                                  css_value);
  _gtk_css_value_unref (css_value);
}

78 79 80
static void
_gtk_css_custom_property_class_init (GtkCssCustomPropertyClass *klass)
{
81 82 83
  GtkStylePropertyClass *property_class = GTK_STYLE_PROPERTY_CLASS (klass);

  property_class->parse_value = gtk_css_custom_property_parse_value;
84
  property_class->query = gtk_css_custom_property_query;
85
  property_class->assign = gtk_css_custom_property_assign;
86 87 88
}

static void
89
_gtk_css_custom_property_init (GtkCssCustomProperty *custom)
90 91 92
{
}

93 94
static GtkCssValue *
gtk_css_custom_property_create_initial_value (GParamSpec *pspec)
95
{
96
  GValue value = G_VALUE_INIT;
97
  GtkCssValue *result;
98

99
  g_value_init (&value, pspec->value_type);
100

Benjamin Otte's avatar
Benjamin Otte committed
101 102

G_GNUC_BEGIN_IGNORE_DEPRECATIONS
103
  if (pspec->value_type == GTK_TYPE_THEMING_ENGINE)
104
    g_value_set_object (&value, gtk_theming_engine_load (NULL));
105
  else if (pspec->value_type == PANGO_TYPE_FONT_DESCRIPTION)
106
    g_value_take_boxed (&value, pango_font_description_from_string ("Sans 10"));
107
  else if (pspec->value_type == GDK_TYPE_RGBA)
108 109 110
    {
      GdkRGBA color;
      gdk_rgba_parse (&color, "pink");
111
      g_value_set_boxed (&value, &color);
112
    }
Matthias Clasen's avatar
Matthias Clasen committed
113
  else if (pspec->value_type == g_type_from_name ("GdkColor"))
114 115 116
    {
      GdkColor color;
      gdk_color_parse ("pink", &color);
117
      g_value_set_boxed (&value, &color);
118 119 120
    }
  else if (pspec->value_type == GTK_TYPE_BORDER)
    {
121
      g_value_take_boxed (&value, gtk_border_new ());
122 123
    }
  else
124
    g_param_value_set_default (pspec, &value);
Benjamin Otte's avatar
Benjamin Otte committed
125
G_GNUC_END_IGNORE_DEPRECATIONS
126

127
  result = _gtk_css_typed_value_new (&value);
128 129 130
  g_value_unset (&value);

  return result;
131 132 133 134 135 136 137
}

/* Property registration functions */

/**
 * gtk_theming_engine_register_property: (skip)
 * @name_space: namespace for the property name
138
 * @parse_func: (nullable): parsing function to use, or %NULL
139 140 141 142 143 144 145 146 147
 * @pspec: the #GParamSpec for the new property
 *
 * Registers a property so it can be used in the CSS file format,
 * on the CSS file the property will look like
 * "-${@name_space}-${property_name}". being
 * ${property_name} the given to @pspec. @name_space will usually
 * be the theme engine name.
 *
 * For any type a @parse_func may be provided, being this function
148
 * used for turning any property value (between “:” and “;”) in
149 150 151 152 153 154 155
 * CSS to the #GValue needed. For basic types there is already
 * builtin parsing support, so %NULL may be provided for these
 * cases.
 *
 * Engines must ensure property registration happens exactly once,
 * usually GTK+ deals with theming engines as singletons, so this
 * should be guaranteed to happen once, but bear this in mind
156
 * when creating #GtkThemeEngines yourself.
157 158 159 160 161
 *
 * In order to make use of the custom registered properties in
 * the CSS file, make sure the engine is loaded first by specifying
 * the engine property, either in a previous rule or within the same
 * one.
162
 * |[
163
 * * {
164 165 166
 *     engine: someengine;
 *     -SomeEngine-custom-property: 2;
 * }
167
 * ]|
168 169
 *
 * Since: 3.0
170 171
 *
 * Deprecated: 3.8: Code should use the default properties provided by CSS.
172 173 174 175 176 177
 **/
void
gtk_theming_engine_register_property (const gchar            *name_space,
                                      GtkStylePropertyParser  parse_func,
                                      GParamSpec             *pspec)
{
178
  GtkCssCustomProperty *node;
179
  GtkCssValue *initial;
180 181 182 183 184 185 186
  gchar *name;

  g_return_if_fail (name_space != NULL);
  g_return_if_fail (strchr (name_space, ' ') == NULL);
  g_return_if_fail (G_IS_PARAM_SPEC (pspec));

  name = g_strdup_printf ("-%s-%s", name_space, pspec->name);
187 188 189 190 191 192 193 194 195

  /* This also initializes the default properties */
  if (_gtk_style_property_lookup (pspec->name))
    {
      g_warning ("a property with name '%s' already exists", name);
      g_free (name);
      return;
    }
  
196
  initial = gtk_css_custom_property_create_initial_value (pspec);
197 198

  node = g_object_new (GTK_TYPE_CSS_CUSTOM_PROPERTY,
199
                       "initial-value", initial,
200 201 202
                       "name", name,
                       "value-type", pspec->value_type,
                       NULL);
203
  node->pspec = pspec;
204 205
  node->property_parse_func = parse_func;

206
  _gtk_css_value_unref (initial);
207 208 209 210 211
  g_free (name);
}

/**
 * gtk_style_properties_register_property: (skip)
212
 * @parse_func: (nullable): parsing function to use, or %NULL
213 214 215 216 217 218 219 220
 * @pspec: the #GParamSpec for the new property
 *
 * Registers a property so it can be used in the CSS file format.
 * This function is the low-level equivalent of
 * gtk_theming_engine_register_property(), if you are implementing
 * a theming engine, you want to use that function instead.
 *
 * Since: 3.0
221 222
 *
 * Deprecated: 3.8: Code should use the default properties provided by CSS.
223 224 225 226 227
 **/
void
gtk_style_properties_register_property (GtkStylePropertyParser  parse_func,
                                        GParamSpec             *pspec)
{
228
  GtkCssCustomProperty *node;
229
  GtkCssValue *initial;
230 231 232

  g_return_if_fail (G_IS_PARAM_SPEC (pspec));

233 234 235 236 237 238 239
  /* This also initializes the default properties */
  if (_gtk_style_property_lookup (pspec->name))
    {
      g_warning ("a property with name '%s' already exists", pspec->name);
      return;
    }
  
240
  initial = gtk_css_custom_property_create_initial_value (pspec);
241 242

  node = g_object_new (GTK_TYPE_CSS_CUSTOM_PROPERTY,
243
                       "initial-value", initial,
244 245 246
                       "name", pspec->name,
                       "value-type", pspec->value_type,
                       NULL);
247
  node->pspec = pspec;
248 249
  node->property_parse_func = parse_func;

250
  _gtk_css_value_unref (initial);
251 252 253 254 255 256 257 258 259 260 261 262 263 264 265
}

/**
 * gtk_style_properties_lookup_property: (skip)
 * @property_name: property name to look up
 * @parse_func: (out): return location for the parse function
 * @pspec: (out) (transfer none): return location for the #GParamSpec
 *
 * Returns %TRUE if a property has been registered, if @pspec or
 * @parse_func are not %NULL, the #GParamSpec and parsing function
 * will be respectively returned.
 *
 * Returns: %TRUE if the property is registered, %FALSE otherwise
 *
 * Since: 3.0
266 267 268
 *
 * Deprecated: 3.8: This code could only look up custom properties and
 *     those are deprecated.
269 270 271 272 273 274 275 276 277 278 279 280 281
 **/
gboolean
gtk_style_properties_lookup_property (const gchar             *property_name,
                                      GtkStylePropertyParser  *parse_func,
                                      GParamSpec             **pspec)
{
  GtkStyleProperty *node;
  gboolean found = FALSE;

  g_return_val_if_fail (property_name != NULL, FALSE);

  node = _gtk_style_property_lookup (property_name);

282
  if (GTK_IS_CSS_CUSTOM_PROPERTY (node))
283
    {
284 285
      GtkCssCustomProperty *custom = GTK_CSS_CUSTOM_PROPERTY (node);

286
      if (pspec)
287
        *pspec = custom->pspec;
288 289

      if (parse_func)
290
        *parse_func = custom->property_parse_func;
291 292 293 294 295 296 297

      found = TRUE;
    }

  return found;
}