path: root/embed/ephy-embed-single.c

 /*
 *  Copyright (C) 2000-2003 Marco Pesenti Gritti
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2, or (at your option)
 *  any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *
 *  $Id$
 */

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "ephy-embed-single.h"
#include "ephy-marshal.h"

static void ephy_embed_single_iface_init (gpointer g_class);

GType
ephy_embed_single_get_type (void)
{
    static GType type = 0;

    if (type == 0)
    {
        static const GTypeInfo our_info =
        {
            sizeof (EphyEmbedSingleIface),
            ephy_embed_single_iface_init,
            NULL,
        };

        type = g_type_register_static (G_TYPE_INTERFACE,
                           "EphyEmbedSingle",
                           &our_info,
                           (GTypeFlags) 0);
    }

    return type;
}

static void
ephy_embed_single_iface_init (gpointer g_class)
{
    static gboolean initialised = FALSE;

    if (initialised == FALSE)
    {
/**
 * EphyEmbedSingle::handle_content:
 * @single:
 * @mime_type: the MIME type of the content
 * @address: the URL to the content
 *
 * The ::handle_content signal is emitted when encountering content of a mime
 * type Epiphany is unable to handle itself.
 *
 * If a connected callback returns %TRUE, the signal will stop propagating. For
 * example, this could be used by a download manager to prevent other
 * ::handle_content listeners from being called.
 **/
    g_signal_new ("handle_content",
              EPHY_TYPE_EMBED_SINGLE,
              G_SIGNAL_RUN_LAST,
              G_STRUCT_OFFSET (EphyEmbedSingleIface, handle_content),
              g_signal_accumulator_true_handled, NULL,
              ephy_marshal_BOOLEAN__STRING_STRING,
              G_TYPE_BOOLEAN,
              2,
              G_TYPE_STRING,
              G_TYPE_STRING);

    initialised = TRUE;
    }
}

/**
 * ephy_embed_single_clear_cache:
 * @single: the #EphyEmbedSingle
 * 
 * Clears the Mozilla cache (temporarily saved web pages).
 **/
void
ephy_embed_single_clear_cache (EphyEmbedSingle *single)
{
    EphyEmbedSingleIface *iface = EPHY_EMBED_SINGLE_GET_IFACE (single);
    iface->clear_cache (single);
}

/**
 * ephy_embed_single_clear_auth_cache:
 * @single: the #EphyEmbedSingle
 * 
 * Clears the Mozilla HTTP authentication cache.
 *
 * This does not clear regular website passwords; it only clears the HTTP
 * authentication cache. Websites which use HTTP authentication require the
 * browser to send a password along with every HTTP request; the browser will
 * ask the user for the password once and then cache the password for subsequent
 * HTTP requests. This function will clear the HTTP authentication cache,
 * meaning the user will have to re-enter a username and password the next time
 * Epiphany requests a web page secured with HTTP authentication.
 **/
void
ephy_embed_single_clear_auth_cache (EphyEmbedSingle *single)
{
    EphyEmbedSingleIface *iface = EPHY_EMBED_SINGLE_GET_IFACE (single);
    iface->clear_auth_cache (single);
}

/**
 * ephy_embed_single_set_offline_mode:
 * @single: the #EphyEmbedSingle
 * @offline: %TRUE to disable networking
 * 
 * Sets the state of the network connection.
 **/
void
ephy_embed_single_set_offline_mode (EphyEmbedSingle *single,
                    gboolean offline)
{
    EphyEmbedSingleIface *iface = EPHY_EMBED_SINGLE_GET_IFACE (single);
    iface->set_offline_mode (single, offline);
}

/**
 * ephy_embed_single_load_proxy_autoconf:
 * @single: the #EphyEmbedSingle
 * @url: a URL to a PAC file
 * 
 * Sets the address of the PAC file, and loads the proxy configuration from it.
 **/
void
ephy_embed_single_load_proxy_autoconf (EphyEmbedSingle *single,
                       const char* url)
{
    EphyEmbedSingleIface *iface = EPHY_EMBED_SINGLE_GET_IFACE (single);
    iface->load_proxy_autoconf (single, url);
}

/**
 * ephy_embed_single_get_font_list:
 * @single: the #EphyEmbedSingle
 * @lang_group: a mozilla font language group name, or %NULL
 * 
 * Returns the list of fonts matching @lang_group, or all fonts if @lang_group
 * is %NULL.
 *
 * The available @lang_group arguments are listed in Epiphany's Fonts and Colors
 * preferences.
 * 
 * Return value: a list of font names
 **/
GList *
ephy_embed_single_get_font_list (EphyEmbedSingle *single,
                 const char *lang_group)
{
    EphyEmbedSingleIface *iface = EPHY_EMBED_SINGLE_GET_IFACE (single);
    return iface->get_font_list (single, lang_group);
}

/**
 * ephy_embed_single_open_window:
 * @single: the #EphyEmbedSingle
 * @parent: the requested window's parent #EphyEmbed
 * @address: the URL to load
 * @features: a Javascript features string
 *
 * Opens a new window, as if it were opened in @parent using the Javascript
 * method and arguments: <code>window.open(&quot;@address&quot;,
 * &quot;_blank&quot;, &quot;@features&quot;);</code>.
 * 
 * Use ephy_shell_new_tab() unless this handling of the @features string is
 * required.
 */
void
ephy_embed_single_open_window (EphyEmbedSingle *single,
                   EphyEmbed *parent,
                   const char *address,
                   const char *features)
{
    EphyEmbedSingleIface *iface = EPHY_EMBED_SINGLE_GET_IFACE (single);
    return iface->open_window (single, parent, address, features);
}