<!-- ##### 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> <!-- ##### ENUM EmbedPersistFlags ##### --> <para> Determines how the #EphyEmbedPersist should act. </para> @EMBED_PERSIST_COPY_PAGE: If set, download a copy of the page being browsed by the #EphyEmbedPersist's #EphyEmbed. This should be specified with ephy_embed_persist_set_embed(). If unset, ephy_embed_persist_set_source() must have been called. @EMBED_PERSIST_MAINDOC: If set and %EMBED_PERSIST_COPY_PAGE is set, download the #EphyEmbedPersist's #EphyEmbed's page's frameset. If unset, download the currently-focused frame. @EMBED_PERSIST_NO_VIEW: If set, do not display this download in the download manager. @EMBED_PERSIST_ASK_DESTINATION: If set, display a filechooser dialog. You must call ephy_embed_persist_set_fc_title() and ephy_embed_persist_set_fc_parent() before ephy_embed_persist_save() if this is the case. If unset, use the destination specified with ephy_embed_persist_set_dest(). <!-- ##### 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: @Param2: <!-- # Unused Parameters # --> @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: