/* Fo * fo-property-background-image.c: 'background-image' property * * Copyright (C) 2001 Sun Microsystems * Copyright (C) 2007 Menteith Consulting Ltd * * See COPYING for the status of this software. */ #include #include "fo-utils.h" #include "fo-context.h" #include "datatype/fo-datatype.h" #include "property/fo-property-private.h" #include "property/fo-property-font-size.h" #include "property/fo-property-background-image.h" /* background-image */ /* Inherited: FALSE */ /* Shorthand: FALSE */ /* | none | inherit */ /* Initial value: none */ struct _FoPropertyBackgroundImage { FoProperty parent_instance; }; struct _FoPropertyBackgroundImageClass { FoPropertyClass parent_class; }; static void fo_property_background_image_init (FoPropertyBackgroundImage *property_background_image); static void fo_property_background_image_class_init (FoPropertyBackgroundImageClass *klass); static void fo_property_background_image_finalize (GObject *object); static FoDatatype* fo_property_background_image_resolve_enum (const gchar *token, FoContext *context, GError **error); static FoDatatype* fo_property_background_image_validate (FoDatatype *datatype, FoContext *context, GError **error); static const gchar class_name[] = "background-image"; static gpointer parent_class; /** * fo_property_background_image_get_type: * * Register the #FoPropertyBackgroundImage type if not already registered and * return its #GType value. * * Return value: #GType of #FoPropertyBackgroundImage. **/ GType fo_property_background_image_get_type (void) { static GType object_type = 0; if (!object_type) { static const GTypeInfo object_info = { sizeof (FoPropertyBackgroundImageClass), NULL, /* base_init */ NULL, /* base_finalize */ (GClassInitFunc) fo_property_background_image_class_init, NULL, /* class_finalize */ NULL, /* class_data */ sizeof (FoPropertyBackgroundImage), 0, /* n_preallocs */ (GInstanceInitFunc) fo_property_background_image_init, NULL /* value_table */ }; object_type = g_type_register_static (FO_TYPE_PROPERTY, class_name, &object_info, 0); } return object_type; } /** * fo_property_background_image_init: * @background_image: #FoPropertyBackgroundImage object to initialise. * * Implements #GInstanceInitFunc for #FoPropertyBackgroundImage. **/ void fo_property_background_image_init (FoPropertyBackgroundImage *background_image) { FO_PROPERTY (background_image)->value = g_object_ref (fo_enum_get_enum_none ()); } /** * fo_property_background_image_class_init: * @klass: #FoPropertyBackgroundImageClass object to initialise. * * Implements #GClassInitFunc for #FoPropertyBackgroundImageClass. **/ void fo_property_background_image_class_init (FoPropertyBackgroundImageClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); FoPropertyClass *property_class = FO_PROPERTY_CLASS (klass); parent_class = g_type_class_peek_parent (klass); object_class->finalize = fo_property_background_image_finalize; property_class->is_inherited = FALSE; property_class->is_shorthand = FALSE; property_class->resolve_enum = fo_property_background_image_resolve_enum; property_class->validate = fo_property_background_image_validate; property_class->get_initial = fo_property_background_image_get_initial; } /** * fo_property_background_image_finalize: * @object: #FoPropertyBackgroundImage object to finalize. * * Implements #GObjectFinalizeFunc for #FoPropertyBackgroundImage. **/ void fo_property_background_image_finalize (GObject *object) { FoPropertyBackgroundImage *background_image; background_image = FO_PROPERTY_BACKGROUND_IMAGE (object); G_OBJECT_CLASS (parent_class)->finalize (object); } /** * fo_property_background_image_new: * * Creates a new #FoPropertyBackgroundImage initialized to default value. * * Return value: the new #FoPropertyBackgroundImage. **/ FoProperty* fo_property_background_image_new (void) { FoProperty* background_image; background_image = FO_PROPERTY (g_object_new (fo_property_background_image_get_type (), NULL)); return background_image; } /** * fo_property_background_image_resolve_enum: * @token: Token from the XML attribute value to be evaluated as an * enumeration token. * @context: #FoContext object from which to possibly inherit values. * @error: Information about any error that has occurred. * * Compare @token against the enumeration tokens that are valid for the * current FO property. If @token is valid, returns either an #FoEnum datatype * representing the enumeration token or a different datatype representing * the enumeration token's resolved value. If @token is not valid, * sets @error and returns NULL. * * Return value: Resolved enumeration value or NULL. **/ FoDatatype* fo_property_background_image_resolve_enum (const gchar *token, FoContext *context, GError **error) { g_return_val_if_fail (token != NULL, NULL); g_return_val_if_fail (FO_IS_CONTEXT (context), NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); if ((strcmp (token, "none") == 0)) { return g_object_ref (fo_enum_get_enum_by_nick (token)); } else { g_set_error (error, FO_FO_ERROR, FO_FO_ERROR_ENUMERATION_TOKEN, _(fo_fo_error_messages[FO_FO_ERROR_ENUMERATION_TOKEN]), class_name, token); return NULL; } } /** * fo_property_background_image_validate: * @datatype: #FoDatatype to be validated against allowed datatypes and * values for current property. * @context: #FoContext object from which to possibly inherit values. * @error: Information about any error that has occurred. * * Validates @datatype against allowed values. Returns @datatype, a * replacement datatype value, or NULL if validation failed. * * Return value: Valid datatype value or NULL. **/ FoDatatype* fo_property_background_image_validate (FoDatatype *datatype, FoContext *context, GError **error) { FoDatatype *new_datatype; GError *tmp_error = NULL; gchar *token; g_return_val_if_fail (datatype != NULL, NULL); g_return_val_if_fail (FO_IS_DATATYPE (datatype), NULL); g_return_val_if_fail (context != NULL, NULL); g_return_val_if_fail (FO_IS_CONTEXT (context), NULL); g_return_val_if_fail (error == NULL || *error == NULL, NULL); if (FO_IS_URI_SPECIFICATION (datatype)) { return datatype; } else if (FO_IS_ENUM (datatype)) { gint value = fo_enum_get_value (datatype); if ((value == FO_ENUM_ENUM_NONE)) { return datatype; } else { gchar *datatype_sprintf = fo_object_sprintf (datatype); g_set_error (error, FO_FO_ERROR, FO_FO_ERROR_ENUMERATION_TOKEN, _(fo_fo_error_messages[FO_FO_ERROR_ENUMERATION_TOKEN]), class_name, datatype_sprintf, g_type_name (G_TYPE_FROM_INSTANCE (datatype))); g_object_unref (datatype); g_free (datatype_sprintf); return NULL; } } else if (FO_IS_STRING (datatype)) { token = fo_string_get_value (datatype); new_datatype = fo_property_background_image_resolve_enum (token, context, &tmp_error); g_object_unref (datatype); fo_propagate_and_return_val_if_error (error, tmp_error, NULL); return new_datatype; } else if (FO_IS_NAME (datatype)) { token = fo_name_get_value (datatype); new_datatype = fo_property_background_image_resolve_enum (token, context, &tmp_error); g_object_unref (datatype); fo_propagate_and_return_val_if_error (error, tmp_error, NULL); return new_datatype; } else { gchar *datatype_sprintf = fo_object_sprintf (datatype); g_set_error (error, FO_FO_ERROR, FO_FO_ERROR_DATATYPE, _(fo_fo_error_messages[FO_FO_ERROR_DATATYPE]), class_name, datatype_sprintf, g_type_name (G_TYPE_FROM_INSTANCE (datatype))); g_object_unref (datatype); g_free (datatype_sprintf); return NULL; } } /** * fo_property_background_image_get_initial: * * Get an instance of the property with the correct initial value. * * Return value: An instance of the property. **/ FoProperty* fo_property_background_image_get_initial (void) { static FoProperty *background_image = NULL; if (background_image == NULL) { background_image = fo_property_background_image_new (); } return background_image; }