1011 lines
		
	
	
		
			27 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			1011 lines
		
	
	
		
			27 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* GTK - The GIMP Toolkit
 | 
						|
 * Copyright (C) 2010 Carlos Garnacho <carlosg@gnome.org>
 | 
						|
 *
 | 
						|
 * 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 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
 | 
						|
 * License along with this library; if not, write to the
 | 
						|
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 | 
						|
 * Boston, MA 02111-1307, USA.
 | 
						|
 */
 | 
						|
 | 
						|
#include "config.h"
 | 
						|
 | 
						|
#include "gtkstylepropertiesprivate.h"
 | 
						|
 | 
						|
#include <stdlib.h>
 | 
						|
#include <gobject/gvaluecollector.h>
 | 
						|
#include <cairo-gobject.h>
 | 
						|
 | 
						|
#include "gtkstyleprovider.h"
 | 
						|
#include "gtksymboliccolor.h"
 | 
						|
#include "gtkthemingengine.h"
 | 
						|
#include "gtkanimationdescription.h"
 | 
						|
#include "gtkgradient.h"
 | 
						|
#include "gtkshadowprivate.h"
 | 
						|
#include "gtkcsstypesprivate.h"
 | 
						|
#include "gtkborderimageprivate.h"
 | 
						|
 | 
						|
#include "gtkstylepropertyprivate.h"
 | 
						|
#include "gtkintl.h"
 | 
						|
 | 
						|
/**
 | 
						|
 * SECTION:gtkstyleproperties
 | 
						|
 * @Short_description: Store for style property information
 | 
						|
 * @Title: GtkStyleProperties
 | 
						|
 *
 | 
						|
 * GtkStyleProperties provides the storage for style information
 | 
						|
 * that is used by #GtkStyleContext and other #GtkStyleProvider
 | 
						|
 * implementations.
 | 
						|
 *
 | 
						|
 * Before style properties can be stored in GtkStyleProperties, they
 | 
						|
 * must be registered with gtk_style_properties_register_property().
 | 
						|
 *
 | 
						|
 * Unless you are writing a #GtkStyleProvider implementation, you
 | 
						|
 * are unlikely to use this API directly, as gtk_style_context_get()
 | 
						|
 * and its variants are the preferred way to access styling information
 | 
						|
 * from widget implementations and theming engine implementations
 | 
						|
 * should use the APIs provided by #GtkThemingEngine instead.
 | 
						|
 */
 | 
						|
 | 
						|
typedef struct GtkStylePropertiesPrivate GtkStylePropertiesPrivate;
 | 
						|
typedef struct PropertyData PropertyData;
 | 
						|
typedef struct ValueData ValueData;
 | 
						|
 | 
						|
struct ValueData
 | 
						|
{
 | 
						|
  GtkStateFlags state;
 | 
						|
  GValue value;
 | 
						|
};
 | 
						|
 | 
						|
struct PropertyData
 | 
						|
{
 | 
						|
  GArray *values;
 | 
						|
};
 | 
						|
 | 
						|
struct GtkStylePropertiesPrivate
 | 
						|
{
 | 
						|
  GHashTable *color_map;
 | 
						|
  GHashTable *properties;
 | 
						|
};
 | 
						|
 | 
						|
static void gtk_style_properties_provider_init (GtkStyleProviderIface *iface);
 | 
						|
static void gtk_style_properties_finalize      (GObject      *object);
 | 
						|
 | 
						|
 | 
						|
G_DEFINE_TYPE_EXTENDED (GtkStyleProperties, gtk_style_properties, G_TYPE_OBJECT, 0,
 | 
						|
                        G_IMPLEMENT_INTERFACE (GTK_TYPE_STYLE_PROVIDER,
 | 
						|
                                               gtk_style_properties_provider_init));
 | 
						|
 | 
						|
static void
 | 
						|
gtk_style_properties_class_init (GtkStylePropertiesClass *klass)
 | 
						|
{
 | 
						|
  GObjectClass *object_class = G_OBJECT_CLASS (klass);
 | 
						|
 | 
						|
  object_class->finalize = gtk_style_properties_finalize;
 | 
						|
 | 
						|
  g_type_class_add_private (object_class, sizeof (GtkStylePropertiesPrivate));
 | 
						|
}
 | 
						|
 | 
						|
static PropertyData *
 | 
						|
property_data_new (void)
 | 
						|
{
 | 
						|
  PropertyData *data;
 | 
						|
 | 
						|
  data = g_slice_new0 (PropertyData);
 | 
						|
  data->values = g_array_new (FALSE, FALSE, sizeof (ValueData));
 | 
						|
 | 
						|
  return data;
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
property_data_remove_values (PropertyData *data)
 | 
						|
{
 | 
						|
  guint i;
 | 
						|
 | 
						|
  for (i = 0; i < data->values->len; i++)
 | 
						|
    {
 | 
						|
      ValueData *value_data;
 | 
						|
 | 
						|
      value_data = &g_array_index (data->values, ValueData, i);
 | 
						|
 | 
						|
      if (G_IS_VALUE (&value_data->value))
 | 
						|
        g_value_unset (&value_data->value);
 | 
						|
    }
 | 
						|
 | 
						|
  if (data->values->len > 0)
 | 
						|
    g_array_remove_range (data->values, 0, data->values->len);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
property_data_free (PropertyData *data)
 | 
						|
{
 | 
						|
  property_data_remove_values (data);
 | 
						|
  g_array_free (data->values, TRUE);
 | 
						|
  g_slice_free (PropertyData, data);
 | 
						|
}
 | 
						|
 | 
						|
static gboolean
 | 
						|
property_data_find_position (PropertyData  *data,
 | 
						|
                             GtkStateFlags  state,
 | 
						|
                             guint         *pos)
 | 
						|
{
 | 
						|
  gint min, max, mid;
 | 
						|
  gboolean found = FALSE;
 | 
						|
  guint position;
 | 
						|
 | 
						|
  if (pos)
 | 
						|
    *pos = 0;
 | 
						|
 | 
						|
  if (data->values->len == 0)
 | 
						|
    return FALSE;
 | 
						|
 | 
						|
  /* Find position for the given state, or the position where
 | 
						|
   * it would be if not found, the array is ordered by the
 | 
						|
   * state flags.
 | 
						|
   */
 | 
						|
  min = 0;
 | 
						|
  max = data->values->len - 1;
 | 
						|
 | 
						|
  do
 | 
						|
    {
 | 
						|
      ValueData *value_data;
 | 
						|
 | 
						|
      mid = (min + max) / 2;
 | 
						|
      value_data = &g_array_index (data->values, ValueData, mid);
 | 
						|
 | 
						|
      if (value_data->state == state)
 | 
						|
        {
 | 
						|
          found = TRUE;
 | 
						|
          position = mid;
 | 
						|
        }
 | 
						|
      else if (value_data->state < state)
 | 
						|
          position = min = mid + 1;
 | 
						|
      else
 | 
						|
        {
 | 
						|
          max = mid - 1;
 | 
						|
          position = mid;
 | 
						|
        }
 | 
						|
    }
 | 
						|
  while (!found && min <= max);
 | 
						|
 | 
						|
  if (pos)
 | 
						|
    *pos = position;
 | 
						|
 | 
						|
  return found;
 | 
						|
}
 | 
						|
 | 
						|
static GValue *
 | 
						|
property_data_get_value (PropertyData  *data,
 | 
						|
                         GtkStateFlags  state)
 | 
						|
{
 | 
						|
  ValueData *val_data;
 | 
						|
  guint pos;
 | 
						|
 | 
						|
  if (!property_data_find_position (data, state, &pos))
 | 
						|
    {
 | 
						|
      ValueData new = { 0 };
 | 
						|
 | 
						|
      new.state = state;
 | 
						|
      g_array_insert_val (data->values, pos, new);
 | 
						|
    }
 | 
						|
 | 
						|
  val_data = &g_array_index (data->values, ValueData, pos);
 | 
						|
 | 
						|
  return &val_data->value;
 | 
						|
}
 | 
						|
 | 
						|
static GValue *
 | 
						|
property_data_match_state (PropertyData  *data,
 | 
						|
                           GtkStateFlags  state)
 | 
						|
{
 | 
						|
  guint pos;
 | 
						|
  gint i;
 | 
						|
 | 
						|
  if (property_data_find_position (data, state, &pos))
 | 
						|
    {
 | 
						|
      ValueData *val_data;
 | 
						|
 | 
						|
      /* Exact match */
 | 
						|
      val_data = &g_array_index (data->values, ValueData, pos);
 | 
						|
      return &val_data->value;
 | 
						|
    }
 | 
						|
 | 
						|
  if (pos >= data->values->len)
 | 
						|
    pos = data->values->len - 1;
 | 
						|
 | 
						|
  /* No exact match, go downwards the list to find
 | 
						|
   * the closest match to the given state flags, as
 | 
						|
   * a side effect, there is an implicit precedence
 | 
						|
   * of higher flags over the smaller ones.
 | 
						|
   */
 | 
						|
  for (i = pos; i >= 0; i--)
 | 
						|
    {
 | 
						|
      ValueData *val_data;
 | 
						|
 | 
						|
      val_data = &g_array_index (data->values, ValueData, i);
 | 
						|
 | 
						|
       /* Check whether any of the requested
 | 
						|
        * flags are set, and no other flags are.
 | 
						|
        *
 | 
						|
        * Also, no flags acts as a wildcard, such
 | 
						|
        * value should be always in the first position
 | 
						|
        * in the array (if present) anyways.
 | 
						|
        */
 | 
						|
      if (val_data->state == 0 ||
 | 
						|
          ((val_data->state & state) != 0 &&
 | 
						|
           (val_data->state & ~state) == 0))
 | 
						|
        return &val_data->value;
 | 
						|
    }
 | 
						|
 | 
						|
  return NULL;
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_style_properties_init (GtkStyleProperties *props)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
 | 
						|
  priv = props->priv = G_TYPE_INSTANCE_GET_PRIVATE (props,
 | 
						|
                                                    GTK_TYPE_STYLE_PROPERTIES,
 | 
						|
                                                    GtkStylePropertiesPrivate);
 | 
						|
 | 
						|
  priv->properties = g_hash_table_new_full (NULL, NULL, NULL,
 | 
						|
                                            (GDestroyNotify) property_data_free);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_style_properties_finalize (GObject *object)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
  GtkStyleProperties *props;
 | 
						|
 | 
						|
  props = GTK_STYLE_PROPERTIES (object);
 | 
						|
  priv = props->priv;
 | 
						|
  g_hash_table_destroy (priv->properties);
 | 
						|
 | 
						|
  if (priv->color_map)
 | 
						|
    g_hash_table_destroy (priv->color_map);
 | 
						|
 | 
						|
  G_OBJECT_CLASS (gtk_style_properties_parent_class)->finalize (object);
 | 
						|
}
 | 
						|
 | 
						|
GtkStyleProperties *
 | 
						|
gtk_style_properties_get_style (GtkStyleProvider *provider,
 | 
						|
                                GtkWidgetPath    *path)
 | 
						|
{
 | 
						|
  /* Return style set itself */
 | 
						|
  return g_object_ref (provider);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_style_properties_provider_init (GtkStyleProviderIface *iface)
 | 
						|
{
 | 
						|
  iface->get_style = gtk_style_properties_get_style;
 | 
						|
}
 | 
						|
 | 
						|
/* Property registration functions */
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_register_property: (skip)
 | 
						|
 * @parse_func: parsing function to use, or %NULL
 | 
						|
 * @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
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_register_property (GtkStylePropertyParser  parse_func,
 | 
						|
                                        GParamSpec             *pspec)
 | 
						|
{
 | 
						|
  g_return_if_fail (G_IS_PARAM_SPEC (pspec));
 | 
						|
 | 
						|
  _gtk_style_property_register (pspec,
 | 
						|
                                0,
 | 
						|
                                parse_func,
 | 
						|
                                NULL,
 | 
						|
                                NULL,
 | 
						|
                                NULL,
 | 
						|
                                NULL,
 | 
						|
                                NULL,
 | 
						|
                                NULL);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * 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
 | 
						|
 **/
 | 
						|
gboolean
 | 
						|
gtk_style_properties_lookup_property (const gchar             *property_name,
 | 
						|
                                      GtkStylePropertyParser  *parse_func,
 | 
						|
                                      GParamSpec             **pspec)
 | 
						|
{
 | 
						|
  const GtkStyleProperty *node;
 | 
						|
  gboolean found = FALSE;
 | 
						|
 | 
						|
  g_return_val_if_fail (property_name != NULL, FALSE);
 | 
						|
 | 
						|
  node = _gtk_style_property_lookup (property_name);
 | 
						|
 | 
						|
  if (node)
 | 
						|
    {
 | 
						|
      if (pspec)
 | 
						|
        *pspec = node->pspec;
 | 
						|
 | 
						|
      if (parse_func)
 | 
						|
        *parse_func = node->property_parse_func;
 | 
						|
 | 
						|
      found = TRUE;
 | 
						|
    }
 | 
						|
 | 
						|
  return found;
 | 
						|
}
 | 
						|
 | 
						|
/* GtkStyleProperties methods */
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_new:
 | 
						|
 *
 | 
						|
 * Returns a newly created #GtkStyleProperties
 | 
						|
 *
 | 
						|
 * Returns: a new #GtkStyleProperties
 | 
						|
 **/
 | 
						|
GtkStyleProperties *
 | 
						|
gtk_style_properties_new (void)
 | 
						|
{
 | 
						|
  return g_object_new (GTK_TYPE_STYLE_PROPERTIES, NULL);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_map_color:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @name: color name
 | 
						|
 * @color: #GtkSymbolicColor to map @name to
 | 
						|
 *
 | 
						|
 * Maps @color so it can be referenced by @name. See
 | 
						|
 * gtk_style_properties_lookup_color()
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_map_color (GtkStyleProperties *props,
 | 
						|
                                const gchar        *name,
 | 
						|
                                GtkSymbolicColor   *color)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
  g_return_if_fail (name != NULL);
 | 
						|
  g_return_if_fail (color != NULL);
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
 | 
						|
  if (G_UNLIKELY (!priv->color_map))
 | 
						|
    priv->color_map = g_hash_table_new_full (g_str_hash,
 | 
						|
                                             g_str_equal,
 | 
						|
                                             (GDestroyNotify) g_free,
 | 
						|
                                             (GDestroyNotify) gtk_symbolic_color_unref);
 | 
						|
 | 
						|
  g_hash_table_replace (priv->color_map,
 | 
						|
                        g_strdup (name),
 | 
						|
                        gtk_symbolic_color_ref (color));
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_lookup_color:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @name: color name to lookup
 | 
						|
 *
 | 
						|
 * Returns the symbolic color that is mapped
 | 
						|
 * to @name.
 | 
						|
 *
 | 
						|
 * Returns: (transfer none): The mapped color
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
GtkSymbolicColor *
 | 
						|
gtk_style_properties_lookup_color (GtkStyleProperties *props,
 | 
						|
                                   const gchar        *name)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
 | 
						|
  g_return_val_if_fail (GTK_IS_STYLE_PROPERTIES (props), NULL);
 | 
						|
  g_return_val_if_fail (name != NULL, NULL);
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
 | 
						|
  if (!priv->color_map)
 | 
						|
    return NULL;
 | 
						|
 | 
						|
  return g_hash_table_lookup (priv->color_map, name);
 | 
						|
}
 | 
						|
 | 
						|
void
 | 
						|
_gtk_style_properties_set_property_by_property (GtkStyleProperties     *props,
 | 
						|
                                                const GtkStyleProperty *style_prop,
 | 
						|
                                                GtkStateFlags           state,
 | 
						|
                                                const GValue           *value)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
  PropertyData *prop;
 | 
						|
  GType value_type;
 | 
						|
  GValue *val;
 | 
						|
 | 
						|
  value_type = G_VALUE_TYPE (value);
 | 
						|
 | 
						|
  if (style_prop->pspec->value_type == GDK_TYPE_RGBA ||
 | 
						|
      style_prop->pspec->value_type == GDK_TYPE_COLOR)
 | 
						|
    {
 | 
						|
      /* Allow GtkSymbolicColor as well */
 | 
						|
      g_return_if_fail (value_type == GDK_TYPE_RGBA ||
 | 
						|
                        value_type == GDK_TYPE_COLOR ||
 | 
						|
                        value_type == GTK_TYPE_SYMBOLIC_COLOR);
 | 
						|
    }
 | 
						|
  else if (style_prop->pspec->value_type == CAIRO_GOBJECT_TYPE_PATTERN)
 | 
						|
    {
 | 
						|
      /* Allow GtkGradient as a substitute */
 | 
						|
      g_return_if_fail (value_type == CAIRO_GOBJECT_TYPE_PATTERN ||
 | 
						|
                        value_type == GTK_TYPE_GRADIENT);
 | 
						|
    }
 | 
						|
  else if (style_prop->pspec->value_type == G_TYPE_INT)
 | 
						|
    {
 | 
						|
      g_return_if_fail (value_type == G_TYPE_INT ||
 | 
						|
                        value_type == GTK_TYPE_CSS_BORDER_RADIUS);
 | 
						|
    }
 | 
						|
  else
 | 
						|
    g_return_if_fail (style_prop->pspec->value_type == value_type);
 | 
						|
 | 
						|
  if (_gtk_style_property_is_shorthand (style_prop))
 | 
						|
    {
 | 
						|
      GParameter *parameters;
 | 
						|
      guint i, n_parameters;
 | 
						|
 | 
						|
      parameters = _gtk_style_property_unpack (style_prop, value, &n_parameters);
 | 
						|
 | 
						|
      for (i = 0; i < n_parameters; i++)
 | 
						|
        {
 | 
						|
          gtk_style_properties_set_property (props,
 | 
						|
                                             parameters[i].name,
 | 
						|
                                             state,
 | 
						|
                                             ¶meters[i].value);
 | 
						|
          g_value_unset (¶meters[i].value);
 | 
						|
        }
 | 
						|
      g_free (parameters);
 | 
						|
      return;
 | 
						|
    }
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
  prop = g_hash_table_lookup (priv->properties, style_prop);
 | 
						|
 | 
						|
  if (!prop)
 | 
						|
    {
 | 
						|
      prop = property_data_new ();
 | 
						|
      g_hash_table_insert (priv->properties, (gpointer) style_prop, prop);
 | 
						|
    }
 | 
						|
 | 
						|
  val = property_data_get_value (prop, state);
 | 
						|
 | 
						|
  if (G_VALUE_TYPE (val) == value_type)
 | 
						|
    g_value_reset (val);
 | 
						|
  else
 | 
						|
    {
 | 
						|
      if (G_IS_VALUE (val))
 | 
						|
        g_value_unset (val);
 | 
						|
 | 
						|
      g_value_init (val, value_type);
 | 
						|
    }
 | 
						|
 | 
						|
  g_value_copy (value, val);
 | 
						|
  if (style_prop->pspec->value_type == value_type)
 | 
						|
    g_param_value_validate (style_prop->pspec, val);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_set_property:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @property: styling property to set
 | 
						|
 * @state: state to set the value for
 | 
						|
 * @value: new value for the property
 | 
						|
 *
 | 
						|
 * Sets a styling property in @props.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_set_property (GtkStyleProperties *props,
 | 
						|
                                   const gchar        *property,
 | 
						|
                                   GtkStateFlags       state,
 | 
						|
                                   const GValue       *value)
 | 
						|
{
 | 
						|
  const GtkStyleProperty *node;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
  g_return_if_fail (property != NULL);
 | 
						|
  g_return_if_fail (value != NULL);
 | 
						|
 | 
						|
  node = _gtk_style_property_lookup (property);
 | 
						|
 | 
						|
  if (!node)
 | 
						|
    {
 | 
						|
      g_warning ("Style property \"%s\" is not registered", property);
 | 
						|
      return;
 | 
						|
    }
 | 
						|
 | 
						|
  _gtk_style_properties_set_property_by_property (props,
 | 
						|
                                                  node,
 | 
						|
                                                  state,
 | 
						|
                                                  value);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_set_valist:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @state: state to set the values for
 | 
						|
 * @args: va_list of property name/value pairs, followed by %NULL
 | 
						|
 *
 | 
						|
 * Sets several style properties on @props.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_set_valist (GtkStyleProperties *props,
 | 
						|
                                 GtkStateFlags       state,
 | 
						|
                                 va_list             args)
 | 
						|
{
 | 
						|
  const gchar *property_name;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
 | 
						|
  property_name = va_arg (args, const gchar *);
 | 
						|
 | 
						|
  while (property_name)
 | 
						|
    {
 | 
						|
      const GtkStyleProperty *node;
 | 
						|
      gchar *error = NULL;
 | 
						|
      GValue val = { 0 };
 | 
						|
 | 
						|
      node = _gtk_style_property_lookup (property_name);
 | 
						|
 | 
						|
      if (!node)
 | 
						|
        {
 | 
						|
          g_warning ("Style property \"%s\" is not registered", property_name);
 | 
						|
          break;
 | 
						|
        }
 | 
						|
 | 
						|
      G_VALUE_COLLECT_INIT (&val, node->pspec->value_type,
 | 
						|
                            args, 0, &error);
 | 
						|
      if (error)
 | 
						|
        {
 | 
						|
          g_warning ("Could not set style property \"%s\": %s", property_name, error);
 | 
						|
          g_value_unset (&val);
 | 
						|
          g_free (error);
 | 
						|
          break;
 | 
						|
        }
 | 
						|
 | 
						|
      _gtk_style_properties_set_property_by_property (props, node, state, &val);
 | 
						|
      g_value_unset (&val);
 | 
						|
 | 
						|
      property_name = va_arg (args, const gchar *);
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_set:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @state: state to set the values for
 | 
						|
 * @...: property name/value pairs, followed by %NULL
 | 
						|
 *
 | 
						|
 * Sets several style properties on @props.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_set (GtkStyleProperties *props,
 | 
						|
                          GtkStateFlags       state,
 | 
						|
                          ...)
 | 
						|
{
 | 
						|
  va_list args;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
 | 
						|
  va_start (args, state);
 | 
						|
  gtk_style_properties_set_valist (props, state, args);
 | 
						|
  va_end (args);
 | 
						|
}
 | 
						|
 | 
						|
/* NB: Will return NULL for shorthands */
 | 
						|
const GValue *
 | 
						|
_gtk_style_properties_peek_property (GtkStyleProperties      *props,
 | 
						|
                                     const gchar             *prop_name,
 | 
						|
                                     GtkStateFlags            state,
 | 
						|
                                     const GtkStyleProperty **property)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
  const GtkStyleProperty *node;
 | 
						|
  PropertyData *prop;
 | 
						|
  GValue *val;
 | 
						|
 | 
						|
  g_return_val_if_fail (GTK_IS_STYLE_PROPERTIES (props), NULL);
 | 
						|
  g_return_val_if_fail (prop_name != NULL, NULL);
 | 
						|
 | 
						|
  node = _gtk_style_property_lookup (prop_name);
 | 
						|
  if (property)
 | 
						|
    *property = node;
 | 
						|
 | 
						|
  if (!node)
 | 
						|
    {
 | 
						|
      g_warning ("Style property \"%s\" is not registered", prop_name);
 | 
						|
      return NULL;
 | 
						|
    }
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
  prop = g_hash_table_lookup (priv->properties, node);
 | 
						|
 | 
						|
  if (!prop)
 | 
						|
    return NULL;
 | 
						|
 | 
						|
  val = property_data_match_state (prop, state);
 | 
						|
  if (val == NULL)
 | 
						|
    return NULL;
 | 
						|
  
 | 
						|
  _gtk_style_property_resolve (node, props, state, val);
 | 
						|
 | 
						|
  return val;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_get_property:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @property: style property name
 | 
						|
 * @state: state to retrieve the property value for
 | 
						|
 * @value: (out) (transfer full):  return location for the style property value.
 | 
						|
 *
 | 
						|
 * Gets a style property from @props for the given state. When done with @value,
 | 
						|
 * g_value_unset() needs to be called to free any allocated memory.
 | 
						|
 *
 | 
						|
 * Returns: %TRUE if the property exists in @props, %FALSE otherwise
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
gboolean
 | 
						|
gtk_style_properties_get_property (GtkStyleProperties *props,
 | 
						|
                                   const gchar        *property,
 | 
						|
                                   GtkStateFlags       state,
 | 
						|
                                   GValue             *value)
 | 
						|
{
 | 
						|
  const GtkStyleProperty *node;
 | 
						|
  const GValue *val;
 | 
						|
 | 
						|
  g_return_val_if_fail (GTK_IS_STYLE_PROPERTIES (props), FALSE);
 | 
						|
  g_return_val_if_fail (property != NULL, FALSE);
 | 
						|
  g_return_val_if_fail (value != NULL, FALSE);
 | 
						|
 | 
						|
  val = _gtk_style_properties_peek_property (props, property, state, &node);
 | 
						|
 | 
						|
  if (!node)
 | 
						|
    return FALSE;
 | 
						|
 | 
						|
  g_value_init (value, node->pspec->value_type);
 | 
						|
 | 
						|
  if (val)
 | 
						|
    g_value_copy (val, value);
 | 
						|
  else if (_gtk_style_property_is_shorthand (node))
 | 
						|
    _gtk_style_property_pack (node, props, state, value);
 | 
						|
  else
 | 
						|
    _gtk_style_property_default_value (node, props, state, value);
 | 
						|
 | 
						|
  return TRUE;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_get_valist:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @state: state to retrieve the property values for
 | 
						|
 * @args: va_list of property name/return location pairs, followed by %NULL
 | 
						|
 *
 | 
						|
 * Retrieves several style property values from @props for a given state.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_get_valist (GtkStyleProperties *props,
 | 
						|
                                 GtkStateFlags       state,
 | 
						|
                                 va_list             args)
 | 
						|
{
 | 
						|
  const gchar *property_name;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
 | 
						|
  property_name = va_arg (args, const gchar *);
 | 
						|
 | 
						|
  while (property_name)
 | 
						|
    {
 | 
						|
      const GtkStyleProperty *node;
 | 
						|
      gchar *error = NULL;
 | 
						|
      const GValue *val;
 | 
						|
 | 
						|
      val = _gtk_style_properties_peek_property (props, property_name, state, &node);
 | 
						|
      if (!node)
 | 
						|
        break;
 | 
						|
 | 
						|
      if (val)
 | 
						|
        {
 | 
						|
          G_VALUE_LCOPY (val, args, 0, &error);
 | 
						|
        }
 | 
						|
      else if (_gtk_style_property_is_shorthand (node))
 | 
						|
        {
 | 
						|
          GValue packed = { 0 };
 | 
						|
 | 
						|
          g_value_init (&packed, node->pspec->value_type);
 | 
						|
          _gtk_style_property_pack (node, props, state, &packed);
 | 
						|
          G_VALUE_LCOPY (&packed, args, 0, &error);
 | 
						|
          g_value_unset (&packed);
 | 
						|
        }
 | 
						|
      else
 | 
						|
        {
 | 
						|
          GValue default_value = { 0 };
 | 
						|
 | 
						|
          g_value_init (&default_value, node->pspec->value_type);
 | 
						|
          _gtk_style_property_default_value (node, props, state, &default_value);
 | 
						|
          G_VALUE_LCOPY (&default_value, args, 0, &error);
 | 
						|
          g_value_unset (&default_value);
 | 
						|
        }
 | 
						|
 | 
						|
      if (error)
 | 
						|
        {
 | 
						|
          g_warning ("Could not get style property \"%s\": %s", property_name, error);
 | 
						|
          g_free (error);
 | 
						|
          break;
 | 
						|
        }
 | 
						|
 | 
						|
      property_name = va_arg (args, const gchar *);
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_get:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @state: state to retrieve the property values for
 | 
						|
 * @...: property name /return value pairs, followed by %NULL
 | 
						|
 *
 | 
						|
 * Retrieves several style property values from @props for a
 | 
						|
 * given state.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_get (GtkStyleProperties *props,
 | 
						|
                          GtkStateFlags       state,
 | 
						|
                          ...)
 | 
						|
{
 | 
						|
  va_list args;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
 | 
						|
  va_start (args, state);
 | 
						|
  gtk_style_properties_get_valist (props, state, args);
 | 
						|
  va_end (args);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_unset_property:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @property: property to unset
 | 
						|
 * @state: state to unset
 | 
						|
 *
 | 
						|
 * Unsets a style property in @props.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_unset_property (GtkStyleProperties *props,
 | 
						|
                                     const gchar        *property,
 | 
						|
                                     GtkStateFlags       state)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
  const GtkStyleProperty *node;
 | 
						|
  PropertyData *prop;
 | 
						|
  guint pos;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
  g_return_if_fail (property != NULL);
 | 
						|
 | 
						|
  node = _gtk_style_property_lookup (property);
 | 
						|
 | 
						|
  if (!node)
 | 
						|
    {
 | 
						|
      g_warning ("Style property \"%s\" is not registered", property);
 | 
						|
      return;
 | 
						|
    }
 | 
						|
 | 
						|
  if (node->unset_func)
 | 
						|
    {
 | 
						|
      node->unset_func (props, state);
 | 
						|
      return;
 | 
						|
    }
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
  prop = g_hash_table_lookup (priv->properties, node);
 | 
						|
 | 
						|
  if (!prop)
 | 
						|
    return;
 | 
						|
 | 
						|
  if (property_data_find_position (prop, state, &pos))
 | 
						|
    {
 | 
						|
      ValueData *data;
 | 
						|
 | 
						|
      data = &g_array_index (prop->values, ValueData, pos);
 | 
						|
 | 
						|
      if (G_IS_VALUE (&data->value))
 | 
						|
        g_value_unset (&data->value);
 | 
						|
 | 
						|
      g_array_remove_index (prop->values, pos);
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_clear:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 *
 | 
						|
 * Clears all style information from @props.
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_clear (GtkStyleProperties *props)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
  g_hash_table_remove_all (priv->properties);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_style_properties_merge:
 | 
						|
 * @props: a #GtkStyleProperties
 | 
						|
 * @props_to_merge: a second #GtkStyleProperties
 | 
						|
 * @replace: whether to replace values or not
 | 
						|
 *
 | 
						|
 * Merges into @props all the style information contained
 | 
						|
 * in @props_to_merge. If @replace is %TRUE, the values
 | 
						|
 * will be overwritten, if it is %FALSE, the older values
 | 
						|
 * will prevail.
 | 
						|
 *
 | 
						|
 * Since: 3.0
 | 
						|
 **/
 | 
						|
void
 | 
						|
gtk_style_properties_merge (GtkStyleProperties       *props,
 | 
						|
                            const GtkStyleProperties *props_to_merge,
 | 
						|
                            gboolean                  replace)
 | 
						|
{
 | 
						|
  GtkStylePropertiesPrivate *priv, *priv_to_merge;
 | 
						|
  GHashTableIter iter;
 | 
						|
  gpointer key, value;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props));
 | 
						|
  g_return_if_fail (GTK_IS_STYLE_PROPERTIES (props_to_merge));
 | 
						|
 | 
						|
  priv = props->priv;
 | 
						|
  priv_to_merge = props_to_merge->priv;
 | 
						|
 | 
						|
  /* Merge symbolic color map */
 | 
						|
  if (priv_to_merge->color_map)
 | 
						|
    {
 | 
						|
      g_hash_table_iter_init (&iter, priv_to_merge->color_map);
 | 
						|
 | 
						|
      while (g_hash_table_iter_next (&iter, &key, &value))
 | 
						|
        {
 | 
						|
          const gchar *name;
 | 
						|
          GtkSymbolicColor *color;
 | 
						|
 | 
						|
          name = key;
 | 
						|
          color = value;
 | 
						|
 | 
						|
          if (!replace &&
 | 
						|
              g_hash_table_lookup (priv->color_map, name))
 | 
						|
            continue;
 | 
						|
 | 
						|
          gtk_style_properties_map_color (props, name, color);
 | 
						|
        }
 | 
						|
    }
 | 
						|
 | 
						|
  /* Merge symbolic style properties */
 | 
						|
  g_hash_table_iter_init (&iter, priv_to_merge->properties);
 | 
						|
 | 
						|
  while (g_hash_table_iter_next (&iter, &key, &value))
 | 
						|
    {
 | 
						|
      PropertyData *prop_to_merge = value;
 | 
						|
      PropertyData *prop;
 | 
						|
      guint i;
 | 
						|
 | 
						|
      prop = g_hash_table_lookup (priv->properties, key);
 | 
						|
 | 
						|
      if (!prop)
 | 
						|
        {
 | 
						|
          prop = property_data_new ();
 | 
						|
          g_hash_table_insert (priv->properties, key, prop);
 | 
						|
        }
 | 
						|
 | 
						|
      for (i = 0; i < prop_to_merge->values->len; i++)
 | 
						|
        {
 | 
						|
          ValueData *data;
 | 
						|
          GValue *value;
 | 
						|
 | 
						|
          data = &g_array_index (prop_to_merge->values, ValueData, i);
 | 
						|
 | 
						|
          if (replace && data->state == GTK_STATE_FLAG_NORMAL &&
 | 
						|
              G_VALUE_TYPE (&data->value) != PANGO_TYPE_FONT_DESCRIPTION)
 | 
						|
            {
 | 
						|
              /* Let normal state override all states
 | 
						|
               * previously set in the original set
 | 
						|
               */
 | 
						|
              property_data_remove_values (prop);
 | 
						|
            }
 | 
						|
 | 
						|
          value = property_data_get_value (prop, data->state);
 | 
						|
 | 
						|
          if (G_VALUE_TYPE (&data->value) == PANGO_TYPE_FONT_DESCRIPTION &&
 | 
						|
              G_IS_VALUE (value))
 | 
						|
            {
 | 
						|
              PangoFontDescription *font_desc;
 | 
						|
              PangoFontDescription *font_desc_to_merge;
 | 
						|
 | 
						|
              /* Handle merging of font descriptions */
 | 
						|
              font_desc = g_value_get_boxed (value);
 | 
						|
              font_desc_to_merge = g_value_get_boxed (&data->value);
 | 
						|
 | 
						|
              pango_font_description_merge (font_desc, font_desc_to_merge, replace);
 | 
						|
            }
 | 
						|
          else if (G_VALUE_TYPE (&data->value) == G_TYPE_PTR_ARRAY &&
 | 
						|
                   G_IS_VALUE (value))
 | 
						|
            {
 | 
						|
              GPtrArray *array, *array_to_merge;
 | 
						|
              gint i;
 | 
						|
 | 
						|
              /* Append the array, mainly thought
 | 
						|
               * for the gtk-key-bindings property
 | 
						|
               */
 | 
						|
              array = g_value_get_boxed (value);
 | 
						|
              array_to_merge = g_value_get_boxed (&data->value);
 | 
						|
 | 
						|
              for (i = 0; i < array_to_merge->len; i++)
 | 
						|
                g_ptr_array_add (array, g_ptr_array_index (array_to_merge, i));
 | 
						|
            }
 | 
						|
          else if (replace || !G_IS_VALUE (value))
 | 
						|
            {
 | 
						|
              if (!G_IS_VALUE (value))
 | 
						|
                g_value_init (value, G_VALUE_TYPE (&data->value));
 | 
						|
              else if (G_VALUE_TYPE (value) != G_VALUE_TYPE (&data->value))
 | 
						|
                {
 | 
						|
                  g_value_unset (value);
 | 
						|
                  g_value_init (value, G_VALUE_TYPE (&data->value));
 | 
						|
                }
 | 
						|
 | 
						|
              g_value_copy (&data->value, value);
 | 
						|
            }
 | 
						|
        }
 | 
						|
    }
 | 
						|
}
 |