<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="EphyLocationEntry">
<refmeta>
<refentrytitle role="top_of_page" id="EphyLocationEntry.top_of_page">EphyLocationEntry</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>EPIPHANY Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>EphyLocationEntry</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="EphyLocationEntry.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
                    <link linkend="EphyLocationEntry-struct">EphyLocationEntry</link>;
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-location">ephy_location_entry_set_location</link>    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         const <link linkend="char">char</link> *address,
                                                         const <link linkend="char">char</link> *typed_address);
const <link linkend="char">char</link> *        <link linkend="ephy-location-entry-get-location">ephy_location_entry_get_location</link>    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="gboolean">gboolean</link>            <link linkend="ephy-location-entry-get-can-undo">ephy_location_entry_get_can_undo</link>    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="gboolean">gboolean</link>            <link linkend="ephy-location-entry-get-can-redo">ephy_location_entry_get_can_redo</link>    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="ephy-location-entry-get-entry">ephy_location_entry_get_entry</link>       (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-activate">ephy_location_entry_activate</link>        (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="gboolean">gboolean</link>            <link linkend="ephy-location-entry-reset">ephy_location_entry_reset</link>           (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-undo-reset">ephy_location_entry_undo_reset</link>      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-favicon">ephy_location_entry_set_favicon</link>     (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-secure">ephy_location_entry_set_secure</link>      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="gboolean">gboolean</link> secure);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-show-lock">ephy_location_entry_set_show_lock</link>   (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="gboolean">gboolean</link> show_lock);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-lock-stock">ephy_location_entry_set_lock_stock</link>  (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         const <link linkend="char">char</link> *stock_id);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-lock-tooltip">ephy_location_entry_set_lock_tooltip</link>
                                                        (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         const <link linkend="char">char</link> *tooltip);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-completion">ephy_location_entry_set_completion</link>  (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="GtkTreeModel">GtkTreeModel</link> *model,
                                                         <link linkend="guint">guint</link> text_col,
                                                         <link linkend="guint">guint</link> action_col,
                                                         <link linkend="guint">guint</link> keywords_col,
                                                         <link linkend="guint">guint</link> relevance_col,
                                                         <link linkend="guint">guint</link> url_col,
                                                         <link linkend="guint">guint</link> extra_col,
                                                         <link linkend="guint">guint</link> favicon_col);
<link linkend="void">void</link>                <link linkend="ephy-location-entry-set-match-func">ephy_location_entry_set_match_func</link>  (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="GtkEntryCompletionMatchFunc">GtkEntryCompletionMatchFunc</link> match_func,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);
</synopsis>
</refsynopsisdiv>

<refsect1 id="EphyLocationEntry.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkToolItem">GtkToolItem</link>
                                       +----EphyLocationEntry
</synopsis>
</refsect1>



<refsect1 id="EphyLocationEntry.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
EphyLocationEntry implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkActivatable">GtkActivatable</link>.</para>
</refsect1>


<refsect1 id="EphyLocationEntry.style-properties" role="style_properties">
<title role="style_properties.title">Style Properties</title>
<synopsis>
  &quot;<link linkend="EphyLocationEntry--s-secure-bg-color">secure-bg-color</link>&quot;          <link linkend="GdkColor">GdkColor</link>*             : Read
  &quot;<link linkend="EphyLocationEntry--s-secure-fg-color">secure-fg-color</link>&quot;          <link linkend="GdkColor">GdkColor</link>*             : Read
</synopsis>
</refsect1>

<refsect1 id="EphyLocationEntry.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="EphyLocationEntry-get-location">get-location</link>&quot;                                   : Run First
  &quot;<link linkend="EphyLocationEntry-get-title">get-title</link>&quot;                                      : Run First
  &quot;<link linkend="EphyLocationEntry-lock-clicked">lock-clicked</link>&quot;                                   : Run First
  &quot;<link linkend="EphyLocationEntry-user-changed">user-changed</link>&quot;                                   : Run First
</synopsis>
</refsect1>


<refsect1 id="EphyLocationEntry.description" role="desc">
<title role="desc.title">Description</title>

<para>
</para>
</refsect1>

<refsect1 id="EphyLocationEntry.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="EphyLocationEntry-struct" role="struct">
<title>EphyLocationEntry</title>
<indexterm zone="EphyLocationEntry-struct"><primary>EphyLocationEntry</primary></indexterm>
<programlisting>typedef struct _EphyLocationEntry EphyLocationEntry;</programlisting>
<para>
</para></refsect2>
<refsect2 id="ephy-location-entry-set-location" role="function">
<title>ephy_location_entry_set_location ()</title>
<indexterm zone="ephy-location-entry-set-location"><primary>ephy_location_entry_set_location</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_location    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         const <link linkend="char">char</link> *address,
                                                         const <link linkend="char">char</link> *typed_address);</programlisting>
<para>
Sets the current address of <parameter>entry</parameter> to <parameter>address</parameter>, alternatively a
<parameter>typed_address</parameter> can be used to determine the text to be displayed in the
location entry.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>address</parameter>&#160;:</term>
<listitem><simpara> the address to be set as the current location
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>typed_address</parameter>&#160;:</term>
<listitem><simpara> the address to be shown in the location entry or NULL
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-get-location" role="function">
<title>ephy_location_entry_get_location ()</title>
<indexterm zone="ephy-location-entry-get-location"><primary>ephy_location_entry_get_location</primary></indexterm>
<programlisting>const <link linkend="char">char</link> *        ephy_location_entry_get_location    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Retrieves the text displayed by the internal <link linkend="GtkEntry"><type>GtkEntry</type></link> of <parameter>entry</parameter>. This is
the currently displayed text, like in any <link linkend="GtkEntry."><type>GtkEntry.</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the text inside the inner <link linkend="GtkEntry"><type>GtkEntry</type></link> of <parameter>entry</parameter>, owned by GTK+

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-get-can-undo" role="function">
<title>ephy_location_entry_get_can_undo ()</title>
<indexterm zone="ephy-location-entry-get-can-undo"><primary>ephy_location_entry_get_can_undo</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            ephy_location_entry_get_can_undo    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Wheter <parameter>entry</parameter> can restore the displayed user modified text to the unmodified 
previous text.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> TRUE or FALSE indicating if the text can be restored

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-get-can-redo" role="function">
<title>ephy_location_entry_get_can_redo ()</title>
<indexterm zone="ephy-location-entry-get-can-redo"><primary>ephy_location_entry_get_can_redo</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            ephy_location_entry_get_can_redo    (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Wheter <parameter>entry</parameter> can restore the displayed text to the user modified version
before the undo.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> TRUE or FALSE indicating if the text can be restored

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-get-entry" role="function">
<title>ephy_location_entry_get_entry ()</title>
<indexterm zone="ephy-location-entry-get-entry"><primary>ephy_location_entry_get_entry</primary></indexterm>
<programlisting><link linkend="GtkWidget">GtkWidget</link> *         ephy_location_entry_get_entry       (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Retrieve the internal <link linkend="GtkEntry"><type>GtkEntry</type></link> of the <link linkend="EphyIconEntry"><type>EphyIconEntry</type></link> inside <parameter>entry</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a pointer to the internal <link linkend="GtkEntry"><type>GtkEntry</type></link> of <parameter>entry</parameter>

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-activate" role="function">
<title>ephy_location_entry_activate ()</title>
<indexterm zone="ephy-location-entry-activate"><primary>ephy_location_entry_activate</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_activate        (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Set focus on <parameter>entry</parameter> and select the text whithin. This is called when the
user hits Control+L.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-reset" role="function">
<title>ephy_location_entry_reset ()</title>
<indexterm zone="ephy-location-entry-reset"><primary>ephy_location_entry_reset</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            ephy_location_entry_reset           (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Restore the <parameter>entry</parameter> to the text corresponding to the current location, this
does not fire the user_changed signal. This is called each time the user
presses Escape while the location entry is selected.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> TRUE on success, FALSE otherwise

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-undo-reset" role="function">
<title>ephy_location_entry_undo_reset ()</title>
<indexterm zone="ephy-location-entry-undo-reset"><primary>ephy_location_entry_undo_reset</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_undo_reset      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry);</programlisting>
<para>
Undo a previous ephy_location_entry_reset.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-favicon" role="function">
<title>ephy_location_entry_set_favicon ()</title>
<indexterm zone="ephy-location-entry-set-favicon"><primary>ephy_location_entry_set_favicon</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_favicon     (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf);</programlisting>
<para>
Sets the icon in the internal <link linkend="EphyIconEntry"><type>EphyIconEntry</type></link> of <parameter>entry</parameter></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixbuf</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link> to be set as the icon of the entry
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-secure" role="function">
<title>ephy_location_entry_set_secure ()</title>
<indexterm zone="ephy-location-entry-set-secure"><primary>ephy_location_entry_set_secure</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_secure      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="gboolean">gboolean</link> secure);</programlisting>
<para>
Set <parameter>entry</parameter> to give visual feedback if the page is <parameter>secure</parameter>. If it is, the
location bar will have its background painted differently (yellow by
default).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>secure</parameter>&#160;:</term>
<listitem><simpara> whether the page is secure and thus the location bar should reflect
that
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-show-lock" role="function">
<title>ephy_location_entry_set_show_lock ()</title>
<indexterm zone="ephy-location-entry-set-show-lock"><primary>ephy_location_entry_set_show_lock</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_show_lock   (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="gboolean">gboolean</link> show_lock);</programlisting>
<para>
If <parameter>show_lock</parameter> is TRUE, the location bar will show an icon reflecting the
security level of the page, by default it's shown only in secure and
insecure pages (insecure meaning secure pages with something broken in such
security)</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show_lock</parameter>&#160;:</term>
<listitem><simpara> if <parameter>entry</parameter> should show a lock icon indicating the security level
of the page
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-lock-stock" role="function">
<title>ephy_location_entry_set_lock_stock ()</title>
<indexterm zone="ephy-location-entry-set-lock-stock"><primary>ephy_location_entry_set_lock_stock</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_lock_stock  (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         const <link linkend="char">char</link> *stock_id);</programlisting>
<para>
Set the lock icon to be displayed, to actually show the icon see 
ephy_location_entry_set_show_lock.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>stock_id</parameter>&#160;:</term>
<listitem><simpara> a stock_id from GTK+ stock icons
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-lock-tooltip" role="function">
<title>ephy_location_entry_set_lock_tooltip ()</title>
<indexterm zone="ephy-location-entry-set-lock-tooltip"><primary>ephy_location_entry_set_lock_tooltip</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_lock_tooltip
                                                        (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         const <link linkend="char">char</link> *tooltip);</programlisting>
<para>
Set the text to be displayed when hovering the lock icon of <parameter>entry</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip</parameter>&#160;:</term>
<listitem><simpara> the text to be set in the tooltip for the lock icon
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-completion" role="function">
<title>ephy_location_entry_set_completion ()</title>
<indexterm zone="ephy-location-entry-set-completion"><primary>ephy_location_entry_set_completion</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_completion  (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="GtkTreeModel">GtkTreeModel</link> *model,
                                                         <link linkend="guint">guint</link> text_col,
                                                         <link linkend="guint">guint</link> action_col,
                                                         <link linkend="guint">guint</link> keywords_col,
                                                         <link linkend="guint">guint</link> relevance_col,
                                                         <link linkend="guint">guint</link> url_col,
                                                         <link linkend="guint">guint</link> extra_col,
                                                         <link linkend="guint">guint</link> favicon_col);</programlisting>
<para>
Initializes <parameter>entry</parameter> to have a <link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link> using <parameter>model</parameter> as the
internal <link linkend="GtkModel."><type>GtkModel.</type></link> The *_col arguments are for internal data retrieval from
<parameter>model</parameter>, like when setting the text property of one of the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
of the completion.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>model</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkModel"><type>GtkModel</type></link> for the completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>keywords_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>relevance_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>url_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>extra_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>favicon_col</parameter>&#160;:</term>
<listitem><simpara> column id to access <link linkend="GtkModel"><type>GtkModel</type></link> relevant data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="ephy-location-entry-set-match-func" role="function">
<title>ephy_location_entry_set_match_func ()</title>
<indexterm zone="ephy-location-entry-set-match-func"><primary>ephy_location_entry_set_match_func</primary></indexterm>
<programlisting><link linkend="void">void</link>                ephy_location_entry_set_match_func  (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *entry,
                                                         <link linkend="GtkEntryCompletionMatchFunc">GtkEntryCompletionMatchFunc</link> match_func,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);</programlisting>
<para>
Sets the match_func for the internal <link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link> to <parameter>match_func</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entry</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="EphyLocationEntry"><type>EphyLocationEntry</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>match_func</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryCompletionMatchFunc"><type>GtkEntryCompletionMatchFunc</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> user_data to pass to the <parameter>match_func</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>notify</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GDestroyNotify"><type>GDestroyNotify</type></link>, like the one given to
gtk_entry_completion_set_match_func
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="EphyLocationEntry.style-property-details" role="style_properties_details">
<title role="style_properties_details.title">Style Property Details</title>
<refsect2 id="EphyLocationEntry--s-secure-bg-color" role="property"><title>The <literal>&quot;secure-bg-color&quot;</literal> style property</title>
<indexterm zone="EphyLocationEntry--s-secure-bg-color"><primary>EphyLocationEntry:secure-bg-color</primary></indexterm>
<programlisting>  &quot;secure-bg-color&quot;          <link linkend="GdkColor">GdkColor</link>*             : Read</programlisting>
<para>Background colour to use for secure sites.</para></refsect2>
<refsect2 id="EphyLocationEntry--s-secure-fg-color" role="property"><title>The <literal>&quot;secure-fg-color&quot;</literal> style property</title>
<indexterm zone="EphyLocationEntry--s-secure-fg-color"><primary>EphyLocationEntry:secure-fg-color</primary></indexterm>
<programlisting>  &quot;secure-fg-color&quot;          <link linkend="GdkColor">GdkColor</link>*             : Read</programlisting>
<para>Foreground colour to use for secure sites.</para></refsect2>
</refsect1>

<refsect1 id="EphyLocationEntry.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="EphyLocationEntry-get-location" role="signal"><title>The <literal>&quot;get-location&quot;</literal> signal</title>
<indexterm zone="EphyLocationEntry-get-location"><primary>EphyLocationEntry::get-location</primary></indexterm>
<programlisting><link linkend="gchar">gchar</link>*              user_function                      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *ephylocationentry,
                                                        <link linkend="gpointer">gpointer</link>           user_data)              : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>ephylocationentry</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="EphyLocationEntry-get-title" role="signal"><title>The <literal>&quot;get-title&quot;</literal> signal</title>
<indexterm zone="EphyLocationEntry-get-title"><primary>EphyLocationEntry::get-title</primary></indexterm>
<programlisting><link linkend="gchar">gchar</link>*              user_function                      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *ephylocationentry,
                                                        <link linkend="gpointer">gpointer</link>           user_data)              : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>ephylocationentry</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="EphyLocationEntry-lock-clicked" role="signal"><title>The <literal>&quot;lock-clicked&quot;</literal> signal</title>
<indexterm zone="EphyLocationEntry-lock-clicked"><primary>EphyLocationEntry::lock-clicked</primary></indexterm>
<programlisting><link linkend="void">void</link>                user_function                      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *ephylocationentry,
                                                        <link linkend="gpointer">gpointer</link>           user_data)              : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>ephylocationentry</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="EphyLocationEntry-user-changed" role="signal"><title>The <literal>&quot;user-changed&quot;</literal> signal</title>
<indexterm zone="EphyLocationEntry-user-changed"><primary>EphyLocationEntry::user-changed</primary></indexterm>
<programlisting><link linkend="void">void</link>                user_function                      (<link linkend="EphyLocationEntry">EphyLocationEntry</link> *ephylocationentry,
                                                        <link linkend="gpointer">gpointer</link>           user_data)              : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>ephylocationentry</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
