metadata 3 GSF Library metadata Synopsis GsfDocMetaData; GsfDocMetaData* gsf_doc_meta_data_new (void); GsfDocProp* gsf_doc_meta_data_lookup (GsfDocMetaData const *meta, char const *name); void gsf_doc_meta_data_insert (GsfDocMetaData *meta, char *name, GValue *value); void gsf_doc_meta_data_remove (GsfDocMetaData *meta, char const *name); GsfDocProp* gsf_doc_meta_data_steal (GsfDocMetaData *meta, char const *name); void gsf_doc_meta_data_store (GsfDocMetaData *meta, GsfDocProp *prop); void gsf_doc_meta_data_foreach (GsfDocMetaData const *meta, GHFunc func, gpointer user_data); gsize gsf_doc_meta_data_size (GsfDocMetaData const *meta); GsfDocProp; GsfDocProp* gsf_doc_prop_new (char *name); void gsf_doc_prop_free (GsfDocProp *prop); charconst * gsf_doc_prop_get_name (GsfDocProp const *prop); GValueconst * gsf_doc_prop_get_val (GsfDocProp const *prop); void gsf_doc_prop_set_val (GsfDocProp *prop, GValue *val); charconst * gsf_doc_prop_get_link (GsfDocProp const *prop); void gsf_doc_prop_set_link (GsfDocProp *prop, char *link); GsfDocPropVector; GsfDocPropVector* gsf_docprop_vector_new (void); void gsf_docprop_vector_append (GsfDocPropVector *vector, GValue *value); gchar* gsf_docprop_vector_as_string (GsfDocPropVector *vector); GValueArray* gsf_value_get_docprop_varray (GValue const *value); GsfDocPropVector* gsf_value_get_docprop_vector (GValue const *value); #define GSF_META_NAME_TITLE #define GSF_META_NAME_DESCRIPTION #define GSF_META_NAME_SUBJECT #define GSF_META_NAME_DATE_MODIFIED #define GSF_META_NAME_DATE_CREATED #define GSF_META_NAME_KEYWORDS #define GSF_META_NAME_LANGUAGE #define GSF_META_NAME_REVISION_COUNT #define GSF_META_NAME_EDITING_DURATION #define GSF_META_NAME_TABLE_COUNT #define GSF_META_NAME_IMAGE_COUNT #define GSF_META_NAME_OBJECT_COUNT #define GSF_META_NAME_PAGE_COUNT #define GSF_META_NAME_PARAGRAPH_COUNT #define GSF_META_NAME_WORD_COUNT #define GSF_META_NAME_CHARACTER_COUNT #define GSF_META_NAME_CELL_COUNT #define GSF_META_NAME_SPREADSHEET_COUNT #define GSF_META_NAME_CREATOR #define GSF_META_NAME_TEMPLATE #define GSF_META_NAME_LAST_SAVED_BY #define GSF_META_NAME_LAST_PRINTED #define GSF_META_NAME_SECURITY #define GSF_META_NAME_CATEGORY #define GSF_META_NAME_PRESENTATION_FORMAT #define GSF_META_NAME_THUMBNAIL #define GSF_META_NAME_GENERATOR #define GSF_META_NAME_LINE_COUNT #define GSF_META_NAME_SLIDE_COUNT #define GSF_META_NAME_NOTE_COUNT #define GSF_META_NAME_HIDDEN_SLIDE_COUNT #define GSF_META_NAME_MM_CLIP_COUNT #define GSF_META_NAME_BYTE_COUNT #define GSF_META_NAME_SCALE #define GSF_META_NAME_HEADING_PAIRS #define GSF_META_NAME_DOCUMENT_PARTS #define GSF_META_NAME_MANAGER #define GSF_META_NAME_COMPANY #define GSF_META_NAME_LINKS_DIRTY #define GSF_META_NAME_DICTIONARY #define GSF_META_NAME_MSOLE_UNKNOWN_17 #define GSF_META_NAME_MSOLE_UNKNOWN_18 #define GSF_META_NAME_MSOLE_UNKNOWN_19 #define GSF_META_NAME_MSOLE_UNKNOWN_20 #define GSF_META_NAME_MSOLE_UNKNOWN_21 #define GSF_META_NAME_MSOLE_UNKNOWN_22 #define GSF_META_NAME_MSOLE_UNKNOWN_23 #define GSF_META_NAME_LOCALE_SYSTEM_DEFAULT #define GSF_META_NAME_CASE_SENSITIVE Description Details <anchor id="GsfDocMetaData"/>GsfDocMetaData GsfDocMetaDatatypedef struct _GsfDocMetaData GsfDocMetaData; <anchor id="gsf-doc-meta-data-new"/>gsf_doc_meta_data_new () gsf_doc_meta_data_newGsfDocMetaData* gsf_doc_meta_data_new (void); Returns :a new metadata property collection <anchor id="gsf-doc-meta-data-lookup"/>gsf_doc_meta_data_lookup () gsf_doc_meta_data_lookupGsfDocProp* gsf_doc_meta_data_lookup (GsfDocMetaData const *meta, char const *name); meta : GsfDocMetaData name : Returns :the property with name id in meta. The caller can modify the property value and link but not the name. <anchor id="gsf-doc-meta-data-insert"/>gsf_doc_meta_data_insert () gsf_doc_meta_data_insertvoid gsf_doc_meta_data_insert (GsfDocMetaData *meta, char *name, GValue *value); Take ownership of name and value and insert a property into meta. If a property exists with name, it is replaced (The link is lost) meta : GsfDocMetaData name : value : GValue <anchor id="gsf-doc-meta-data-remove"/>gsf_doc_meta_data_remove () gsf_doc_meta_data_removevoid gsf_doc_meta_data_remove (GsfDocMetaData *meta, char const *name); If name does not exist in the collection, do nothing. If name does exist, remove it and its value from the collection meta : the collection name : the non-null string name of the property <anchor id="gsf-doc-meta-data-steal"/>gsf_doc_meta_data_steal () gsf_doc_meta_data_stealGsfDocProp* gsf_doc_meta_data_steal (GsfDocMetaData *meta, char const *name); meta : name : Returns : <anchor id="gsf-doc-meta-data-store"/>gsf_doc_meta_data_store () gsf_doc_meta_data_storevoid gsf_doc_meta_data_store (GsfDocMetaData *meta, GsfDocProp *prop); meta : GsfDocMetaData prop : GsfDocProp <anchor id="gsf-doc-meta-data-foreach"/>gsf_doc_meta_data_foreach () gsf_doc_meta_data_foreachvoid gsf_doc_meta_data_foreach (GsfDocMetaData const *meta, GHFunc func, gpointer user_data); Iterate through each (key, value) pair in this collection meta : the collection func : the function called once for each element in the collection user_data : any supplied user data or NULL <anchor id="gsf-doc-meta-data-size"/>gsf_doc_meta_data_size () gsf_doc_meta_data_sizegsize gsf_doc_meta_data_size (GsfDocMetaData const *meta); meta : the collection Returns :the number of items in this collection <anchor id="GsfDocProp"/>GsfDocProp GsfDocProptypedef struct _GsfDocProp GsfDocProp; <anchor id="gsf-doc-prop-new"/>gsf_doc_prop_new () gsf_doc_prop_newGsfDocProp* gsf_doc_prop_new (char *name); name : Returns :a new GsfDocProp which the caller is responsible for freeing. Takes ownership of name. <anchor id="gsf-doc-prop-free"/>gsf_doc_prop_free () gsf_doc_prop_freevoid gsf_doc_prop_free (GsfDocProp *prop); If prop is non NULL free the memory assosociated with it prop : GsfDocProp <anchor id="gsf-doc-prop-get-name"/>gsf_doc_prop_get_name () gsf_doc_prop_get_namecharconst * gsf_doc_prop_get_name (GsfDocProp const *prop); prop : GsfDocProp Returns :the name of the property, the caller should not modify the result. <anchor id="gsf-doc-prop-get-val"/>gsf_doc_prop_get_val () gsf_doc_prop_get_valGValueconst * gsf_doc_prop_get_val (GsfDocProp const *prop); prop : the property Returns :the value of the property, the caller should not modify the result. <anchor id="gsf-doc-prop-set-val"/>gsf_doc_prop_set_val () gsf_doc_prop_set_valvoid gsf_doc_prop_set_val (GsfDocProp *prop, GValue *val); Assigns val to prop, and unsets and frees the current value. prop : GsfDocProp val : GValue <anchor id="gsf-doc-prop-get-link"/>gsf_doc_prop_get_link () gsf_doc_prop_get_linkcharconst * gsf_doc_prop_get_link (GsfDocProp const *prop); prop : GsfDocProp Returns :the current link descriptor of prop. The result should not be freed or modified. <anchor id="gsf-doc-prop-set-link"/>gsf_doc_prop_set_link () gsf_doc_prop_set_linkvoid gsf_doc_prop_set_link (GsfDocProp *prop, char *link); prop : GsfDocProp link : <anchor id="GsfDocPropVector"/>GsfDocPropVector GsfDocPropVectortypedef struct _GsfDocPropVector GsfDocPropVector; <anchor id="gsf-docprop-vector-new"/>gsf_docprop_vector_new () gsf_docprop_vector_newGsfDocPropVector* gsf_docprop_vector_new (void); This function creates a new gsf_docprop_vector object. Returns : GsfDocPropVector* <anchor id="gsf-docprop-vector-append"/>gsf_docprop_vector_append () gsf_docprop_vector_appendvoid gsf_docprop_vector_append (GsfDocPropVector *vector, GValue *value); Insert a copy of value as the last element of vector. vector : The vector to which the GValue will be added value : The GValue to add to vector <anchor id="gsf-docprop-vector-as-string"/>gsf_docprop_vector_as_string () gsf_docprop_vector_as_stringgchar* gsf_docprop_vector_as_string (GsfDocPropVector *vector); This function returns a string which represents all the GValues in vector. The caller is responsible for freeing the result. vector : The GsfDocPropVector from which GValues will be extracted. Returns : a string of comma-separated values <anchor id="gsf-value-get-docprop-varray"/>gsf_value_get_docprop_varray () gsf_value_get_docprop_varrayGValueArray* gsf_value_get_docprop_varray (GValue const *value); value : Returns : <anchor id="gsf-value-get-docprop-vector"/>gsf_value_get_docprop_vector () gsf_value_get_docprop_vectorGsfDocPropVector* gsf_value_get_docprop_vector (GValue const *value); value : Returns : <anchor id="GSF-META-NAME-TITLE:CAPS"/>GSF_META_NAME_TITLE GSF_META_NAME_TITLE#define GSF_META_NAME_TITLE "dc:title" <anchor id="GSF-META-NAME-DESCRIPTION:CAPS"/>GSF_META_NAME_DESCRIPTION GSF_META_NAME_DESCRIPTION#define GSF_META_NAME_DESCRIPTION "dc:description" <anchor id="GSF-META-NAME-SUBJECT:CAPS"/>GSF_META_NAME_SUBJECT GSF_META_NAME_SUBJECT#define GSF_META_NAME_SUBJECT "dc:subject" <anchor id="GSF-META-NAME-DATE-MODIFIED:CAPS"/>GSF_META_NAME_DATE_MODIFIED GSF_META_NAME_DATE_MODIFIED#define GSF_META_NAME_DATE_MODIFIED "dc:date-modified" <anchor id="GSF-META-NAME-DATE-CREATED:CAPS"/>GSF_META_NAME_DATE_CREATED GSF_META_NAME_DATE_CREATED#define GSF_META_NAME_DATE_CREATED "gsf:date-created" <anchor id="GSF-META-NAME-KEYWORDS:CAPS"/>GSF_META_NAME_KEYWORDS GSF_META_NAME_KEYWORDS#define GSF_META_NAME_KEYWORDS "dc:keywords" <anchor id="GSF-META-NAME-LANGUAGE:CAPS"/>GSF_META_NAME_LANGUAGE GSF_META_NAME_LANGUAGE#define GSF_META_NAME_LANGUAGE "dc:language" <anchor id="GSF-META-NAME-REVISION-COUNT:CAPS"/>GSF_META_NAME_REVISION_COUNT GSF_META_NAME_REVISION_COUNT#define GSF_META_NAME_REVISION_COUNT "gsf:revision-count" <anchor id="GSF-META-NAME-EDITING-DURATION:CAPS"/>GSF_META_NAME_EDITING_DURATION GSF_META_NAME_EDITING_DURATION#define GSF_META_NAME_EDITING_DURATION "gsf:editing-duration" <anchor id="GSF-META-NAME-TABLE-COUNT:CAPS"/>GSF_META_NAME_TABLE_COUNT GSF_META_NAME_TABLE_COUNT#define GSF_META_NAME_TABLE_COUNT "gsf:table-count" <anchor id="GSF-META-NAME-IMAGE-COUNT:CAPS"/>GSF_META_NAME_IMAGE_COUNT GSF_META_NAME_IMAGE_COUNT#define GSF_META_NAME_IMAGE_COUNT "gsf:image-count" <anchor id="GSF-META-NAME-OBJECT-COUNT:CAPS"/>GSF_META_NAME_OBJECT_COUNT GSF_META_NAME_OBJECT_COUNT#define GSF_META_NAME_OBJECT_COUNT "gsf:object-count" <anchor id="GSF-META-NAME-PAGE-COUNT:CAPS"/>GSF_META_NAME_PAGE_COUNT GSF_META_NAME_PAGE_COUNT#define GSF_META_NAME_PAGE_COUNT "gsf:page-count" <anchor id="GSF-META-NAME-PARAGRAPH-COUNT:CAPS"/>GSF_META_NAME_PARAGRAPH_COUNT GSF_META_NAME_PARAGRAPH_COUNT#define GSF_META_NAME_PARAGRAPH_COUNT "gsf:paragraph-count" <anchor id="GSF-META-NAME-WORD-COUNT:CAPS"/>GSF_META_NAME_WORD_COUNT GSF_META_NAME_WORD_COUNT#define GSF_META_NAME_WORD_COUNT "gsf:word-count" <anchor id="GSF-META-NAME-CHARACTER-COUNT:CAPS"/>GSF_META_NAME_CHARACTER_COUNT GSF_META_NAME_CHARACTER_COUNT#define GSF_META_NAME_CHARACTER_COUNT "gsf:character-count" <anchor id="GSF-META-NAME-CELL-COUNT:CAPS"/>GSF_META_NAME_CELL_COUNT GSF_META_NAME_CELL_COUNT#define GSF_META_NAME_CELL_COUNT "gsf:cell-count" <anchor id="GSF-META-NAME-SPREADSHEET-COUNT:CAPS"/>GSF_META_NAME_SPREADSHEET_COUNT GSF_META_NAME_SPREADSHEET_COUNT#define GSF_META_NAME_SPREADSHEET_COUNT "gsf:spreadsheet-count" <anchor id="GSF-META-NAME-CREATOR:CAPS"/>GSF_META_NAME_CREATOR GSF_META_NAME_CREATOR#define GSF_META_NAME_CREATOR "gsf:creator" <anchor id="GSF-META-NAME-TEMPLATE:CAPS"/>GSF_META_NAME_TEMPLATE GSF_META_NAME_TEMPLATE#define GSF_META_NAME_TEMPLATE "gsf:template" <anchor id="GSF-META-NAME-LAST-SAVED-BY:CAPS"/>GSF_META_NAME_LAST_SAVED_BY GSF_META_NAME_LAST_SAVED_BY#define GSF_META_NAME_LAST_SAVED_BY "gsf:last-saved-by" <anchor id="GSF-META-NAME-LAST-PRINTED:CAPS"/>GSF_META_NAME_LAST_PRINTED GSF_META_NAME_LAST_PRINTED#define GSF_META_NAME_LAST_PRINTED "gsf:last-printed" <anchor id="GSF-META-NAME-SECURITY:CAPS"/>GSF_META_NAME_SECURITY GSF_META_NAME_SECURITY#define GSF_META_NAME_SECURITY "gsf:security" <anchor id="GSF-META-NAME-CATEGORY:CAPS"/>GSF_META_NAME_CATEGORY GSF_META_NAME_CATEGORY#define GSF_META_NAME_CATEGORY "gsf:category" <anchor id="GSF-META-NAME-PRESENTATION-FORMAT:CAPS"/>GSF_META_NAME_PRESENTATION_FORMAT GSF_META_NAME_PRESENTATION_FORMAT#define GSF_META_NAME_PRESENTATION_FORMAT "gsf:presentation-format" <anchor id="GSF-META-NAME-THUMBNAIL:CAPS"/>GSF_META_NAME_THUMBNAIL GSF_META_NAME_THUMBNAIL#define GSF_META_NAME_THUMBNAIL "gsf:thumbnail" <anchor id="GSF-META-NAME-GENERATOR:CAPS"/>GSF_META_NAME_GENERATOR GSF_META_NAME_GENERATOR#define GSF_META_NAME_GENERATOR "gsf:generator" <anchor id="GSF-META-NAME-LINE-COUNT:CAPS"/>GSF_META_NAME_LINE_COUNT GSF_META_NAME_LINE_COUNT#define GSF_META_NAME_LINE_COUNT "gsf:line-count" <anchor id="GSF-META-NAME-SLIDE-COUNT:CAPS"/>GSF_META_NAME_SLIDE_COUNT GSF_META_NAME_SLIDE_COUNT#define GSF_META_NAME_SLIDE_COUNT "gsf:slide-count" <anchor id="GSF-META-NAME-NOTE-COUNT:CAPS"/>GSF_META_NAME_NOTE_COUNT GSF_META_NAME_NOTE_COUNT#define GSF_META_NAME_NOTE_COUNT "gsf:note-count" <anchor id="GSF-META-NAME-HIDDEN-SLIDE-COUNT:CAPS"/>GSF_META_NAME_HIDDEN_SLIDE_COUNT GSF_META_NAME_HIDDEN_SLIDE_COUNT#define GSF_META_NAME_HIDDEN_SLIDE_COUNT "gsf:hidden-slide-count" <anchor id="GSF-META-NAME-MM-CLIP-COUNT:CAPS"/>GSF_META_NAME_MM_CLIP_COUNT GSF_META_NAME_MM_CLIP_COUNT#define GSF_META_NAME_MM_CLIP_COUNT "gsf:MM-clip-count" <anchor id="GSF-META-NAME-BYTE-COUNT:CAPS"/>GSF_META_NAME_BYTE_COUNT GSF_META_NAME_BYTE_COUNT#define GSF_META_NAME_BYTE_COUNT "gsf:byte-count" <anchor id="GSF-META-NAME-SCALE:CAPS"/>GSF_META_NAME_SCALE GSF_META_NAME_SCALE#define GSF_META_NAME_SCALE "gsf:scale" <anchor id="GSF-META-NAME-HEADING-PAIRS:CAPS"/>GSF_META_NAME_HEADING_PAIRS GSF_META_NAME_HEADING_PAIRS#define GSF_META_NAME_HEADING_PAIRS "gsf:heading-pairs" <anchor id="GSF-META-NAME-DOCUMENT-PARTS:CAPS"/>GSF_META_NAME_DOCUMENT_PARTS GSF_META_NAME_DOCUMENT_PARTS#define GSF_META_NAME_DOCUMENT_PARTS "gsf:document-parts" <anchor id="GSF-META-NAME-MANAGER:CAPS"/>GSF_META_NAME_MANAGER GSF_META_NAME_MANAGER#define GSF_META_NAME_MANAGER "gsf:manager" <anchor id="GSF-META-NAME-COMPANY:CAPS"/>GSF_META_NAME_COMPANY GSF_META_NAME_COMPANY#define GSF_META_NAME_COMPANY "gsf:company" <anchor id="GSF-META-NAME-LINKS-DIRTY:CAPS"/>GSF_META_NAME_LINKS_DIRTY GSF_META_NAME_LINKS_DIRTY#define GSF_META_NAME_LINKS_DIRTY "gsf:links-dirty" <anchor id="GSF-META-NAME-DICTIONARY:CAPS"/>GSF_META_NAME_DICTIONARY GSF_META_NAME_DICTIONARY#define GSF_META_NAME_DICTIONARY "gsf:dictionary" <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-17:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_17 GSF_META_NAME_MSOLE_UNKNOWN_17#define GSF_META_NAME_MSOLE_UNKNOWN_17 "msole:unknown-doc-17" <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-18:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_18 GSF_META_NAME_MSOLE_UNKNOWN_18#define GSF_META_NAME_MSOLE_UNKNOWN_18 "msole:unknown-doc-18" <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-19:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_19 GSF_META_NAME_MSOLE_UNKNOWN_19#define GSF_META_NAME_MSOLE_UNKNOWN_19 "msole:unknown-doc-19" /* bool */ <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-20:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_20 GSF_META_NAME_MSOLE_UNKNOWN_20#define GSF_META_NAME_MSOLE_UNKNOWN_20 "msole:unknown-doc-20" <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-21:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_21 GSF_META_NAME_MSOLE_UNKNOWN_21#define GSF_META_NAME_MSOLE_UNKNOWN_21 "msole:unknown-doc-21" <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-22:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_22 GSF_META_NAME_MSOLE_UNKNOWN_22#define GSF_META_NAME_MSOLE_UNKNOWN_22 "msole:unknown-doc-22" /* bool */ <anchor id="GSF-META-NAME-MSOLE-UNKNOWN-23:CAPS"/>GSF_META_NAME_MSOLE_UNKNOWN_23 GSF_META_NAME_MSOLE_UNKNOWN_23#define GSF_META_NAME_MSOLE_UNKNOWN_23 "msole:unknown-doc-23" /* i4 */ <anchor id="GSF-META-NAME-LOCALE-SYSTEM-DEFAULT:CAPS"/>GSF_META_NAME_LOCALE_SYSTEM_DEFAULT GSF_META_NAME_LOCALE_SYSTEM_DEFAULT#define GSF_META_NAME_LOCALE_SYSTEM_DEFAULT "gsf:default-locale" <anchor id="GSF-META-NAME-CASE-SENSITIVE:CAPS"/>GSF_META_NAME_CASE_SENSITIVE GSF_META_NAME_CASE_SENSITIVE#define GSF_META_NAME_CASE_SENSITIVE "gsf:case-sensitivity"