CongDispspecElement

CongDispspecElement —

Synopsis




CongDispspecElement* cong_dispspec_element_new
                                            (CongDispspec *ds,
                                             const gchar *local_name,
                                             CongElementType type,
                                             gboolean autogenerate_username);
void        cong_dispspec_element_destroy   (CongDispspecElement *element);
const gchar* cong_dispspec_element_get_ns_uri
                                            (const CongDispspecElement *element);
const char* cong_dispspec_element_get_local_name
                                            (const CongDispspecElement *element);
const char* cong_dispspec_element_username  (CongDispspecElement *element);
const gchar* cong_dispspec_element_get_description
                                            (CongDispspecElement *element);
GdkPixbuf*  cong_dispspec_element_get_icon  (CongDispspecElement *element);
const gchar* cong_dispspec_element_get_value_for_key
                                            (const gchar *key,
                                             const CongDispspecElement *element);
const char* cong_dispspec_element_name_name_get
                                            (CongDispspecElement *element);
void        cong_dispspec_element_set_whitespace
                                            (CongDispspecElement *element,
                                             CongWhitespaceHandling whitespace);
gboolean    cong_dispspec_element_collapseto
                                            (CongDispspecElement *element);
gboolean    cong_dispspec_element_is_structural
                                            (CongDispspecElement *element);
gboolean    cong_dispspec_element_is_span   (CongDispspecElement *element);
GdkGC*      cong_dispspec_element_gc        (CongDispspecElement *element,
                                             CongDispspecGCUsage usage);
const GdkColor* cong_dispspec_element_col   (CongDispspecElement *element,
                                             CongDispspecGCUsage usage);
CongDispspecElementHeaderInfo* cong_dispspec_element_header_info
                                            (CongDispspecElement *element);
const gchar* cong_dispspec_element_header_info_get_xpath_expression
                                            (CongDispspecElementHeaderInfo *header_info);
gchar*      cong_dispspec_element_get_title (CongDispspecElement *element,
                                             CongNodePtr x);
gchar*      cong_dispspec_element_get_section_header_text
                                            (CongDispspecElement *element,
                                             CongNodePtr x);
CongFont*   cong_dispspec_element_get_font  (CongDispspecElement *element,
                                             CongFontRole role);
const gchar* cong_dispspec_element_get_editor_service_id
                                            (CongDispspecElement *element);
const gchar* cong_dispspec_element_get_property_dialog_service_id
                                            (CongDispspecElement *element);
xmlNodePtr  cong_dispspec_element_to_xml    (const CongDispspecElement *element,
                                             xmlDocPtr xml_doc);
CongDispspecElement* cong_dispspec_element_from_xml
                                            (CongDispspec *ds,
                                             xmlNodePtr xml_element);

Description

Details

cong_dispspec_element_new ()

CongDispspecElement* cong_dispspec_element_new
                                            (CongDispspec *ds,
                                             const gchar *local_name,
                                             CongElementType type,
                                             gboolean autogenerate_username);

Constructs a new CongDispspecElement, initialising fields to sane defaults.

ds : the CongDispspec this will be added to
local_name : the local name for the new element; must be non-NULL
type :
autogenerate_username : if TRUE, then generate a sane user-visible name for the element, using "header capitalisation"
Returns : a freshly allocated CongDispspecElement

cong_dispspec_element_destroy ()

void        cong_dispspec_element_destroy   (CongDispspecElement *element);

TODO: Write me

element :

cong_dispspec_element_get_ns_uri ()

const gchar* cong_dispspec_element_get_ns_uri
                                            (const CongDispspecElement *element);

element : the element in question
Returns : the namespace URI for this kind of element, or NULL if none

cong_dispspec_element_get_local_name ()

const char* cong_dispspec_element_get_local_name
                                            (const CongDispspecElement *element);

element : the element in question
Returns : the local name (relative to its namespace, if any) for this kind of element

cong_dispspec_element_username ()

const char* cong_dispspec_element_username  (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_get_description ()

const gchar* cong_dispspec_element_get_description
                                            (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_get_icon ()

GdkPixbuf*  cong_dispspec_element_get_icon  (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_get_value_for_key ()

const gchar* cong_dispspec_element_get_value_for_key
                                            (const gchar *key,
                                             const CongDispspecElement *element);

Dispspec elements support a list of key/value string pairs; this is intended as a mechanism to allow plugins to have arbitrary data whilst having a DTD for xds files.

key : the key
element : the dispspec element
Returns : the value, if found, or NULL if not present.

cong_dispspec_element_name_name_get ()

const char* cong_dispspec_element_name_name_get
                                            (CongDispspecElement *element);

element :
Returns :

cong_dispspec_element_set_whitespace ()

void        cong_dispspec_element_set_whitespace
                                            (CongDispspecElement *element,
                                             CongWhitespaceHandling whitespace);

Set the CongWhitespaceHandling behaviour for this element

element : The element of the display spec
whitespace : The new value for whitespace handling

cong_dispspec_element_collapseto ()

gboolean    cong_dispspec_element_collapseto
                                            (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_is_structural ()

gboolean    cong_dispspec_element_is_structural
                                            (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_is_span ()

gboolean    cong_dispspec_element_is_span   (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_gc ()

GdkGC*      cong_dispspec_element_gc        (CongDispspecElement *element,
                                             CongDispspecGCUsage usage);

TODO: Write me

element :
usage :
Returns :

cong_dispspec_element_col ()

const GdkColor* cong_dispspec_element_col   (CongDispspecElement *element,
                                             CongDispspecGCUsage usage);

TODO: Write me

element :
usage :
Returns :

cong_dispspec_element_header_info ()

CongDispspecElementHeaderInfo* cong_dispspec_element_header_info
                                            (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_header_info_get_xpath_expression ()

const gchar* cong_dispspec_element_header_info_get_xpath_expression
                                            (CongDispspecElementHeaderInfo *header_info);

TODO: Write me

header_info :
Returns :

cong_dispspec_element_get_title ()

gchar*      cong_dispspec_element_get_title (CongDispspecElement *element,
                                             CongNodePtr x);

TODO: Write me

element :
x :
Returns :

cong_dispspec_element_get_section_header_text ()

gchar*      cong_dispspec_element_get_section_header_text
                                            (CongDispspecElement *element,
                                             CongNodePtr x);

TODO: Write me

element :
x :
Returns :

cong_dispspec_element_get_font ()

CongFont*   cong_dispspec_element_get_font  (CongDispspecElement *element,
                                             CongFontRole role);

TODO: Write me

element :
role :
Returns :

cong_dispspec_element_get_editor_service_id ()

const gchar* cong_dispspec_element_get_editor_service_id
                                            (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_get_property_dialog_service_id ()

const gchar* cong_dispspec_element_get_property_dialog_service_id
                                            (CongDispspecElement *element);

TODO: Write me

element :
Returns :

cong_dispspec_element_to_xml ()

xmlNodePtr  cong_dispspec_element_to_xml    (const CongDispspecElement *element,
                                             xmlDocPtr xml_doc);

Create an element tag suitable for adding to an element-list tag within an xds XML document.

element : the dispspec element we are adding
xml_doc : the XML document we are creating
Returns : a newly-created xmlNodePtr

cong_dispspec_element_from_xml ()

CongDispspecElement* cong_dispspec_element_from_xml
                                            (CongDispspec *ds,
                                             xmlNodePtr xml_element);

Create an CongDispspecElement from an xds XML representation

ds : the CongDispspec this will be added to
xml_element : the element within the XML document
Returns : a newly-created CongDispspecElement