Class Resource

Returns resource name.

Returns:

Name of resource. The string is owned by resource and must not be modfied or freed.

Returns whether a resource is modifiable.

Returns:

True if resource is modifiable, False if it's fixed (system) resource.

Returns whether a resource is preferred.

Returns:

True if resource is preferred, False otherwise.

Sets preferability of a resource.

Parameters:

• is_preferred - True to make resource preferred, False to make it not preferred. (bool)

Starts using a resource.

Call to this function is necessary to use a resource properly. It makes the resource to create any auxiliary structures that consume considerable amount of memory and perform other initialization to ready-to-use form.

When a resource is no longer used, it should be released with Resource.release().

In addition, it calls g_object_ref() on the resource.

Resources usually exist through almost whole program lifetime from GObject perspective, but from the viewpoint of use this method is the constructor and Resource.release() is the destructor.

Releases a resource.

When the number of resource uses drops to zero, it frees all auxiliary data and returns back to `latent' form. In addition, it calls g_object_unref() on it. See Resource.use() for more.

Tells whether a resource is currently in use.

See Resource.use() for details.

Returns:

True if resource is in use, False otherwise.

Emits signal "data-changed" on a resource.

It can be called only on non-constant resources. The default handler sets is_modified flag on the resource.

Mostly useful in resource implementation.

Clears is_modified flag of a resource.

Since: 2.8

Builds file name a resource should be saved to.

If the resource has not been newly created, renamed, or system it was probably loaded from file of the same name.

Returns:

Resource file name as a newly allocated string that must be freed by caller.

Dumps a resource to a textual (human readable) form.

Returns:

Textual resource representation.