diff options
Diffstat (limited to 'doc/reference/tmpl/ephy-embed-persist.sgml')
-rw-r--r-- | doc/reference/tmpl/ephy-embed-persist.sgml | 235 |
1 files changed, 235 insertions, 0 deletions
diff --git a/doc/reference/tmpl/ephy-embed-persist.sgml b/doc/reference/tmpl/ephy-embed-persist.sgml new file mode 100644 index 000000000..32fa72e63 --- /dev/null +++ b/doc/reference/tmpl/ephy-embed-persist.sgml @@ -0,0 +1,235 @@ +<!-- ##### SECTION Title ##### --> +EphyEmbedPersist + +<!-- ##### SECTION Short_Description ##### --> +A class to download files + +<!-- ##### SECTION Long_Description ##### --> +<para> +An #EphyEmbedPersist is a relatively simple way to save a web page or file to +disk. It is an abstract class, implemented by #MozillaEmbedPersist. +</para> +<para> +To create an #EphyEmbedPersist, use ephy_embed_factory_new_object(). Next, call +ephy_embed_persist_set_flags() and ephy_embed_persist_set_embed(). Depending +on the flags, you may also want to call ephy_embed_persist_set_dest() or +ephy_embed_persist_set_source(). Finally, call ephy_embed_persist_save() to +save the file. +</para> +<para> +<example> +<title>Saving the current web page to disk</title> +<programlisting>#<![CDATA[include <epiphany/ephy-embed-persist.h>]]> +#<![CDATA[include <epiphany/ephy-embed.h> + +static void +save_source_completed_cb (EphyEmbedPersist *persist, + gpointer dummy) +{ + g_print ("Download to %]]><![CDATA[s complete.\n", + ephy_embed_persist_get_dest (persist)); +} + +void +save_page (EphyEmbed *embed, + const char *filename) +{ + EphyEmbedPersist *persist; + + persist = EPHY_EMBED_PERSIST + (ephy_embed_factory_new_object ("EphyEmbedPersist")); + + ephy_embed_persist_set_embed (persist, embed); + ephy_embed_persist_set_flags (persist, EMBED_PERSIST_NO_VIEW | + EMBED_PERSIST_COPY_PAGE); + ephy_embed_persist_set_dest (persist, filename); + + g_signal_connect (persist, "completed", + G_CALLBACK (save_source_completed_cb), NULL); + + ephy_embed_persist_save (persist); + + g_object_unref (persist); +}]]> +</programlisting> +</example> +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### FUNCTION ephy_embed_persist_set_dest ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_embed ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_fc_title ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_fc_parent ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_flags ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_max_size ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_persist_key ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_set_source ##### --> +<para> + +</para> + +@persist: +@value: + + +<!-- ##### FUNCTION ephy_embed_persist_get_dest ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_embed ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_fc_title ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_fc_parent ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_flags ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_max_size ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_persist_key ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_get_source ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_save ##### --> +<para> + +</para> + +@persist: +@Returns: + + +<!-- ##### FUNCTION ephy_embed_persist_cancel ##### --> +<para> + +</para> + +@persist: + + +<!-- ##### FUNCTION ephy_embed_persist_to_string ##### --> +<para> + +</para> + +@persist: +@Returns: + + |