1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 2010 Carlos Garnacho <carlosg@gnome.org>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
20 #include "gtkstyleprovider.h"
23 #include "gtkprivate.h"
24 #include "gtkwidgetpath.h"
27 * SECTION:gtkstyleprovider
28 * @Short_description: Interface to provide style information to GtkStyleContext
29 * @Title: GtkStyleProvider
30 * @See_also: #GtkStyleContext, #GtkCssProvider
32 * GtkStyleProvider is an interface used to provide style information to a #GtkStyleContext.
33 * See gtk_style_context_add_provider() and gtk_style_context_add_provider_for_screen().
36 static void gtk_style_provider_iface_init (gpointer g_iface);
39 gtk_style_provider_get_type (void)
41 static GType style_provider_type = 0;
43 if (!style_provider_type)
44 style_provider_type = g_type_register_static_simple (G_TYPE_INTERFACE,
45 I_("GtkStyleProvider"),
46 sizeof (GtkStyleProviderIface),
47 (GClassInitFunc) gtk_style_provider_iface_init,
49 return style_provider_type;
53 gtk_style_provider_iface_init (gpointer g_iface)
58 * gtk_style_provider_get_style:
59 * @provider: a #GtkStyleProvider
60 * @path: #GtkWidgetPath to query
62 * Returns the style settings affecting a widget defined by @path, or %NULL if
63 * @provider doesn't contemplate styling @path.
65 * Returns: (transfer full): a #GtkStyleProperties containing the
66 * style settings affecting @path
70 * Deprecated: 3.8: Will always return %NULL for all GTK-provided style providers
71 * as the interface cannot correctly work the way CSS is specified.
74 gtk_style_provider_get_style (GtkStyleProvider *provider,
77 GtkStyleProviderIface *iface;
79 g_return_val_if_fail (GTK_IS_STYLE_PROVIDER (provider), NULL);
81 iface = GTK_STYLE_PROVIDER_GET_IFACE (provider);
83 if (!iface->get_style)
86 return iface->get_style (provider, path);
90 * gtk_style_provider_get_style_property:
91 * @provider: a #GtkStyleProvider
92 * @path: #GtkWidgetPath to query
93 * @state: state to query the style property for
94 * @pspec: The #GParamSpec to query
95 * @value: (out): return location for the property value
97 * Looks up a widget style property as defined by @provider for
98 * the widget represented by @path.
100 * Returns: %TRUE if the property was found and has a value, %FALSE otherwise
105 gtk_style_provider_get_style_property (GtkStyleProvider *provider,
111 GtkStyleProviderIface *iface;
113 g_return_val_if_fail (GTK_IS_STYLE_PROVIDER (provider), FALSE);
114 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
115 g_return_val_if_fail (path != NULL, FALSE);
116 g_return_val_if_fail (g_type_is_a (gtk_widget_path_get_object_type (path), pspec->owner_type), FALSE);
117 g_return_val_if_fail (value != NULL, FALSE);
119 iface = GTK_STYLE_PROVIDER_GET_IFACE (provider);
121 if (!iface->get_style_property)
124 return iface->get_style_property (provider, path, state, pspec, value);
128 * gtk_style_provider_get_icon_factory:
129 * @provider: a #GtkStyleProvider
130 * @path: #GtkWidgetPath to query
132 * Returns the #GtkIconFactory defined to be in use for @path, or %NULL if none
135 * Returns: (transfer none): The icon factory to use for @path, or %NULL
139 * Deprecated: 3.8: Will always return %NULL for all GTK-provided style providers.
142 gtk_style_provider_get_icon_factory (GtkStyleProvider *provider,
145 GtkStyleProviderIface *iface;
147 g_return_val_if_fail (GTK_IS_STYLE_PROVIDER (provider), NULL);
148 g_return_val_if_fail (path != NULL, NULL);
150 iface = GTK_STYLE_PROVIDER_GET_IFACE (provider);
152 if (!iface->get_icon_factory)
155 return iface->get_icon_factory (provider, path);