summaryrefslogtreecommitdiff
path: root/gtk/gtkstyleproperty.c
diff options
context:
space:
mode:
authorBenjamin Otte <otte@redhat.com>2012-01-02 10:06:47 +0100
committerBenjamin Otte <otte@redhat.com>2012-01-09 18:37:54 +0100
commit2d46618e08418c325bd0cc9dd520ffcfbf5d163d (patch)
tree68064181b6b877c0b7fc8804e917c2d570fb44c8 /gtk/gtkstyleproperty.c
parent70af2cb2e3c6a7186632639aa86d4eb1f7fd8e3a (diff)
downloadgtk+-2d46618e08418c325bd0cc9dd520ffcfbf5d163d.tar.gz
styleproperty: Let parse_value() initialize the value
... and document that behavior.
Diffstat (limited to 'gtk/gtkstyleproperty.c')
-rw-r--r--gtk/gtkstyleproperty.c19
1 files changed, 19 insertions, 0 deletions
diff --git a/gtk/gtkstyleproperty.c b/gtk/gtkstyleproperty.c
index 4bc9c38d6f..b181be9065 100644
--- a/gtk/gtkstyleproperty.c
+++ b/gtk/gtkstyleproperty.c
@@ -379,6 +379,25 @@ border_corner_radius_value_print (const GValue *value,
/*** API ***/
+/**
+ * _gtk_style_property_parse_value:
+ * @property: the property
+ * @value: an uninitialized value
+ * @parser: the parser to parse from
+ * @base: the base file for @aprser
+ *
+ * Tries to parse the given @property from the given @parser into
+ * @value. The type that @value will be assigned is dependant on
+ * the parser and no assumptions must be made about it. If the
+ * parsing fails, %FALSE will be returned and @value will be
+ * left uninitialized.
+ *
+ * Only if @property is a #GtkCssShorthandProperty, the @value will
+ * always contain a #GValueArray with the values to be used for
+ * the subproperties.
+ *
+ * Returns: %TRUE on success
+ **/
gboolean
_gtk_style_property_parse_value (GtkStyleProperty *property,
GValue *value,