| GOffice Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
void go_doc_set_pristine (GODoc *doc,gboolean pristine); gboolean go_doc_is_pristine (GODoc const *doc); void go_doc_set_dirty (GODoc *doc,gboolean is_dirty); gboolean go_doc_is_dirty (GODoc const *doc); gboolean go_doc_set_uri (GODoc *doc,char const *uri); char const * go_doc_get_uri (GODoc const *doc); GsfDocMetaData * go_doc_get_meta_data (GODoc const *doc); void go_doc_set_meta_data (GODoc *doc,GsfDocMetaData *data); void go_doc_update_meta_data (GODoc *doc); GOImage * go_doc_get_image (GODoc *doc,char const *id); GOImage * go_doc_add_image (GODoc *doc,char const *id,GOImage *image); GHashTable * go_doc_get_images (GODoc *doc); void go_doc_init_write (GODoc *doc,GsfXMLOut *output); void go_doc_write (GODoc *doc,GsfXMLOut *output); void go_doc_save_image (GODoc *doc,char const *id); void go_doc_init_read (GODoc *doc,GsfInput *input); void go_doc_read (GODoc *doc,GsfXMLIn *xin,xmlChar const **attrs); void go_doc_end_read (GODoc *doc); GOImage * go_doc_image_fetch (GODoc *doc,char const *id,GType type);
void go_doc_set_pristine (GODoc *doc,gboolean pristine);
Sets the indication of whether this document is unchanged since it was created. Note: if both "dirty" and "pristine" are being set, set "pristine" last.
|
GODoc |
|
a gboolean. |
gboolean go_doc_is_pristine (GODoc const *doc);
This checks to see if the doc has ever been used ( approximately )
|
GODoc |
Returns : |
TRUE if we can discard this doc.
|
void go_doc_set_dirty (GODoc *doc,gboolean is_dirty);
Changes the dirty state of doc to is_dirty and clears the pristine state
no matter what.
|
GODoc |
|
bool |
gboolean go_doc_is_dirty (GODoc const *doc);
|
GODoc |
Returns : |
TRUE if doc has been modified.
|
gboolean go_doc_set_uri (GODoc *doc,char const *uri);
|
the document to modify |
|
the uri for this worksheet. |
Returns : |
TRUE if the name was set succesfully. |
GsfDocMetaData * go_doc_get_meta_data (GODoc const *doc);
|
GODoc |
Returns : |
doc's metadata. [transfer none]
|
void go_doc_set_meta_data (GODoc *doc,GsfDocMetaData *data);
Adds a ref to data.
|
GODoc |
|
GsfDocMetaData |
void go_doc_update_meta_data (GODoc *doc);
Signal that doc's metadata should be updated
- statistics (sheet count, word count)
- content (sheet names, bookmarks)
- reloading linked items
|
GODoc |
GOImage * go_doc_get_image (GODoc *doc,char const *id);
|
a GODoc |
|
the image name |
Returns : |
the GOImage is one exist with name id. The caller does not own a
reference. [transfer none]
|
GOImage * go_doc_add_image (GODoc *doc,char const *id,GOImage *image);
Adds image to the document if no such image already exists. The name of
the returned image might be different from id, even if given.
|
a GODoc |
|
the image name or NULL |
|
a GOImage |
Returns : |
either image, in which case the document adds a reference on it, or
an identical image for which the owner does not own a reference. [transfer none]
|
GHashTable * go_doc_get_images (GODoc *doc);
|
GODoc |
Returns : |
the images registered inside the document. [transfer none] |
void go_doc_read (GODoc *doc,GsfXMLIn *xin,xmlChar const **attrs);
|
|
|
|
|
GOImage * go_doc_image_fetch (GODoc *doc,char const *id,GType type);
Searches for a GOImage with name id in the document image buffer and
creates one if needed. The caller does not own a reference on the returned
GOImage.
This function must be called after a call to go_doc_init_read(), otherwise
it will emit a critical and return NULL.