![]() |
![]() |
![]() |
CCSS Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
typedef ccss_stylesheet_t; void (*ccss_stylesheet_iterator_f) (ccss_stylesheet_t *self, char const *type_name, void *user_data); enum ccss_stylesheet_precedence_t; void ccss_stylesheet_destroy (ccss_stylesheet_t *self); ccss_stylesheet_t * ccss_stylesheet_reference (ccss_stylesheet_t *self); unsigned int ccss_stylesheet_get_reference_count (ccss_stylesheet_t const *self); ccss_stylesheet_t * ccss_stylesheet_add_from_file (ccss_stylesheet_t *self, char const *css_file, ccss_stylesheet_precedence_t precedence, void *user_data); void ccss_stylesheet_foreach (ccss_stylesheet_t *self, ccss_stylesheet_iterator_f func, void *user_data); void ccss_stylesheet_invalidate_node (ccss_stylesheet_t const *self, ptrdiff_t instance); ccss_style_t * ccss_stylesheet_query_type (ccss_stylesheet_t *self, char const *type_name); ccss_style_t * ccss_stylesheet_query (ccss_stylesheet_t *self, ccss_node_t const *node); void ccss_stylesheet_dump (ccss_stylesheet_t const *self);
typedef struct ccss_stylesheet_ ccss_stylesheet_t;
Represents a parsed instance of a stylesheet.
void (*ccss_stylesheet_iterator_f) (ccss_stylesheet_t *self, char const *type_name, void *user_data);
Specifies the type of the function passed to ccss_stylesheet_foreach()
.
|
a ccss_stylesheet_t. |
|
node type name selectors are available for, e.g. `div'. |
|
user data passed to ccss_stylesheet_foreach. |
typedef enum { CCSS_STYLESHEET_USER_AGENT = 0, CCSS_STYLESHEET_USER, CCSS_STYLESHEET_AUTHOR } ccss_stylesheet_precedence_t;
See http://www.w3.org/TR/CSS21/cascade.html.
void ccss_stylesheet_destroy (ccss_stylesheet_t *self);
Decreases the reference count on self
by one. If the result is zero, then
self
and all associated resources are freed. See ccss_stylesheet_reference()
.
|
a ccss_stylesheet_t. |
ccss_stylesheet_t * ccss_stylesheet_reference (ccss_stylesheet_t *self);
Increases the reference count on self
by one. This prevents self
from being
destroyed until a matching call to ccss_stylesheet_destroy()
is made.
The number of references to a ccss_stylesheet_t can be acquired using
ccss_stylesheet_get_reference_count()
.
|
a ccss_stylesheet_t. |
Returns : |
the referenced ccss_stylesheet_t. |
unsigned int ccss_stylesheet_get_reference_count (ccss_stylesheet_t const *self);
|
a ccss_stylesheet_t. |
Returns : |
the current reference count of self .
If self is a nil object, 0 will be returned.
|
ccss_stylesheet_t * ccss_stylesheet_add_from_file (ccss_stylesheet_t *self, char const *css_file, ccss_stylesheet_precedence_t precedence, void *user_data);
Load a CSS file with a given precedence.
|
ccss_stylesheet_t instance or NULL .
|
|
file to parse. |
|
see ccss_stylesheet_precedence_t. |
|
user-data passed to property- and function-handlers. |
Returns : |
a ccss_stylesheet_t representation of the CSS file. |
void ccss_stylesheet_foreach (ccss_stylesheet_t *self, ccss_stylesheet_iterator_f func, void *user_data);
The iterator function func
is called for each type in the stylesheet.
|
a ccss_stylesheet_t. |
|
a ccss_stylesheet_iterator_f. |
|
user data to pass to the iterator function. |
void ccss_stylesheet_invalidate_node (ccss_stylesheet_t const *self, ptrdiff_t instance);
Frees parsed inline CSS asocciated to a document node.
|
a ccss_stylesheet_t. |
|
an instance identifyer, as returned by ccss_node_get_instance_f. |
ccss_style_t * ccss_stylesheet_query_type (ccss_stylesheet_t *self, char const *type_name);
Query the stylesheet for styling information regarding a type.
|
a ccss_stylesheet_t. |
|
the type to query for, e.g. `h1'. |
Returns : |
a ccss_style_t that the results of the query are applied to or
NULL if the query didn't yield results.
|
ccss_style_t * ccss_stylesheet_query (ccss_stylesheet_t *self, ccss_node_t const *node);
Query the stylesheet for styling information regarding a document node and apply the results to a ccss_style_t object.
|
a ccss_stylesheet_t. |
|
a ccss_node_t implementation that is used by libccss to retrieve information about the underlying document. |
Returns : |
a ccss_style_t that the results of the query are applied to or
NULL if the query didn't yield results.
|
void ccss_stylesheet_dump (ccss_stylesheet_t const *self);
Print informations about the internal state of this object.
|
a ccss_stylesheet_t. |