path: root/doc/reference/tmpl/ephy-embed-persist.sgml

<!-- ##### 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().
@EMBED_PERSIST_DO_CONVERSION: 

<!-- ##### 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: