cr-cascade

cr-cascade

Synopsis

struct              CRCascade;
                    CRCascadePriv;
void                cr_cascade_destroy                  (CRCascade *a_this);
CRStyleSheet *      cr_cascade_get_sheet                (CRCascade *a_this,
                                                         enum CRStyleOrigin a_origin);
CRCascade *         cr_cascade_new                      (CRStyleSheet *a_author_sheet,
                                                         CRStyleSheet *a_user_sheet,
                                                         CRStyleSheet *a_ua_sheet);
void                cr_cascade_ref                      (CRCascade *a_this);
enum CRStatus       cr_cascade_set_sheet                (CRCascade *a_this,
                                                         CRStyleSheet *a_sheet,
                                                         enum CRStyleOrigin a_origin);
void                cr_cascade_unref                    (CRCascade *a_this);

Description

Details

struct CRCascade

struct CRCascade {
	CRCascadePriv *priv ;
};


CRCascadePriv

typedef struct _CRCascadePriv CRCascadePriv;


cr_cascade_destroy ()

void                cr_cascade_destroy                  (CRCascade *a_this);

Destructor of CRCascade.

a_this :

the current instance of CRCascade

cr_cascade_get_sheet ()

CRStyleSheet *      cr_cascade_get_sheet                (CRCascade *a_this,
                                                         enum CRStyleOrigin a_origin);

Gets a sheet, part of the cascade. Note that the returned stylesheet is refcounted so if the caller wants to manage it's lifecycle, it must use cr_stylesheet_ref()/cr_stylesheet_unref() instead of the cr_stylesheet_destroy() method.

a_this :

the current instance of CRCascade.

a_origin :

the origin of the style sheet as defined in the css2 spec in chapter 6.4. Gets a given origin sheet.

Returns :

the style sheet, or NULL if it does not exist.

cr_cascade_new ()

CRCascade *         cr_cascade_new                      (CRStyleSheet *a_author_sheet,
                                                         CRStyleSheet *a_user_sheet,
                                                         CRStyleSheet *a_ua_sheet);

Constructor of the CRCascade class. Note that all three parameters of this method are ref counted and their refcount is increased. Their refcount will be decreased at the destruction of the instance of CRCascade. So the caller should not call their destructor. The caller should call their ref/unref method instead if it wants

a_author_sheet :

the author origin style sheet. May be NULL.

a_user_sheet :

the user origin style sheet. May be NULL.

a_ua_sheet :

the user agent origin style sheet. May be NULL.

Returns :

the newly built instance of CRCascade or NULL if an error arose during constrution.

cr_cascade_ref ()

void                cr_cascade_ref                      (CRCascade *a_this);

Increases the reference counter of the current instance of CRCascade.

a_this :

the current instance of CRCascade

cr_cascade_set_sheet ()

enum CRStatus       cr_cascade_set_sheet                (CRCascade *a_this,
                                                         CRStyleSheet *a_sheet,
                                                         enum CRStyleOrigin a_origin);

Sets a stylesheet in the cascade

a_this :

the current instance of CRCascade.

a_sheet :

the stylesheet to set.

a_origin :

the origin of the stylesheet.

Returns :

CR_OK upon successfull completion, an error code otherwise.

cr_cascade_unref ()

void                cr_cascade_unref                    (CRCascade *a_this);

Decrements the reference counter associated to this instance of CRCascade. If the reference counter reaches zero, the instance is destroyed using cr_cascade_destroy()

a_this :

the current instance of CRCascade.