![]() |
![]() |
![]() |
Epiphany Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
EphyLocationEntry; void ephy_location_entry_set_location (EphyLocationEntry *entry
,const char *address
); const char * ephy_location_entry_get_location (EphyLocationEntry *entry
); gboolean ephy_location_entry_get_can_undo (EphyLocationEntry *entry
); gboolean ephy_location_entry_get_can_redo (EphyLocationEntry *entry
); void ephy_location_entry_activate (EphyLocationEntry *entry
); gboolean ephy_location_entry_reset (EphyLocationEntry *entry
); void ephy_location_entry_undo_reset (EphyLocationEntry *entry
); void ephy_location_entry_set_favicon (EphyLocationEntry *entry
,GdkPixbuf *pixbuf
); void ephy_location_entry_set_show_lock (EphyLocationEntry *entry
,gboolean show_lock
); void ephy_location_entry_set_lock_stock (EphyLocationEntry *entry
,const char *stock_id
); void ephy_location_entry_set_lock_tooltip (EphyLocationEntry *entry
,const char *tooltip
); void ephy_location_entry_set_completion (EphyLocationEntry *entry
,GtkTreeModel *model
,guint text_col
,guint action_col
,guint keywords_col
,guint relevance_col
,guint url_col
,guint extra_col
,guint favicon_col
); void ephy_location_entry_set_match_func (EphyLocationEntry *entry
,GtkEntryCompletionMatchFunc match_func
,gpointer user_data
,GDestroyNotify notify
);
EphyLocationEntry implements AtkImplementorIface, GtkBuildable, GtkEditable and GtkCellEditable.
"favicon" GdkPixbuf* : Write "location" gchar* : Read / Write "lock-stock-id" gchar* : Write "show-favicon" gboolean : Write "show-lock" gboolean : Write
"get-location" :Run First
"get-title" :Run First
"lock-clicked" :Run First
"user-changed" :Run First
void ephy_location_entry_set_location (EphyLocationEntry *entry
,const char *address
);
Sets the current address of entry
to address
.
|
an EphyLocationEntry widget |
|
new location address |
const char * ephy_location_entry_get_location (EphyLocationEntry *entry
);
Retrieves the text displayed by the internal GtkEntry of entry
. This is
the currently displayed text, like in any GtkEntry.
|
an EphyLocationEntry widget |
Returns : |
the text inside the inner GtkEntry of entry , owned by GTK+ |
gboolean ephy_location_entry_get_can_undo (EphyLocationEntry *entry
);
Wheter entry
can restore the displayed user modified text to the unmodified
previous text.
|
an EphyLocationEntry widget |
Returns : |
TRUE or FALSE indicating if the text can be restored |
gboolean ephy_location_entry_get_can_redo (EphyLocationEntry *entry
);
Wheter entry
can restore the displayed text to the user modified version
before the undo.
|
an EphyLocationEntry widget |
Returns : |
TRUE or FALSE indicating if the text can be restored |
void ephy_location_entry_activate (EphyLocationEntry *entry
);
Set focus on entry
and select the text whithin. This is called when the
user hits Control+L.
|
an EphyLocationEntry widget |
gboolean ephy_location_entry_reset (EphyLocationEntry *entry
);
Restore the entry
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.
|
an EphyLocationEntry widget |
Returns : |
TRUE on success, FALSE otherwise |
void ephy_location_entry_undo_reset (EphyLocationEntry *entry
);
Undo a previous ephy_location_entry_reset.
|
an EphyLocationEntry widget |
void ephy_location_entry_set_favicon (EphyLocationEntry *entry
,GdkPixbuf *pixbuf
);
Sets the icon in the internal EphyIconEntry of entry
|
an EphyLocationEntry widget |
|
a GdkPixbuf to be set as the icon of the entry |
void ephy_location_entry_set_show_lock (EphyLocationEntry *entry
,gboolean show_lock
);
If show_lock
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)
|
an EphyLocationEntry widget |
|
if entry should show a lock icon indicating the security level
of the page |
void ephy_location_entry_set_lock_stock (EphyLocationEntry *entry
,const char *stock_id
);
Set the lock icon to be displayed, to actually show the icon see ephy_location_entry_set_show_lock.
|
an EphyLocationEntry widget |
|
a stock_id from GTK+ stock icons |
void ephy_location_entry_set_lock_tooltip (EphyLocationEntry *entry
,const char *tooltip
);
Set the text to be displayed when hovering the lock icon of entry
.
|
an EphyLocationEntry widget |
|
the text to be set in the tooltip for the lock icon |
void ephy_location_entry_set_completion (EphyLocationEntry *entry
,GtkTreeModel *model
,guint text_col
,guint action_col
,guint keywords_col
,guint relevance_col
,guint url_col
,guint extra_col
,guint favicon_col
);
Initializes entry
to have a GtkEntryCompletion using model
as the
internal GtkModel. The *_col arguments are for internal data retrieval from
model
, like when setting the text property of one of the GtkCellRenderer
of the completion.
|
an EphyLocationEntry widget |
|
the GtkModel for the completion |
|
column id to access GtkModel relevant data |
|
column id to access GtkModel relevant data |
|
column id to access GtkModel relevant data |
|
column id to access GtkModel relevant data |
|
column id to access GtkModel relevant data |
|
column id to access GtkModel relevant data |
|
column id to access GtkModel relevant data |
void ephy_location_entry_set_match_func (EphyLocationEntry *entry
,GtkEntryCompletionMatchFunc match_func
,gpointer user_data
,GDestroyNotify notify
);
Sets the match_func for the internal GtkEntryCompletion to match_func
.
|
an EphyLocationEntry widget |
|
a GtkEntryCompletionMatchFunc |
|
user_data to pass to the match_func
|
|
a GDestroyNotify, like the one given to gtk_entry_completion_set_match_func |
"lock-stock-id"
property "lock-stock-id" gchar* : Write
Stock id of the security icon.
Default value: NULL
"show-favicon"
property "show-favicon" gboolean : Write
Whether to show the favicon.
Default value: TRUE
"get-location"
signalgchar* user_function (EphyLocationEntry *entry,
gpointer user_data) : Run First
For drag and drop purposes, the location bar will request you the real address of where it is pointing to. The signal handler for this function should return the address of the currently loaded site.
|
the object on which the signal is emitted Returns: the current page address as a string |
|
user data set when the signal handler was connected. |
"get-title"
signalgchar* user_function (EphyLocationEntry *entry,
gpointer user_data) : Run First
For drag and drop purposes, the location bar will request you the title of where it is pointing to. The signal handler for this function should return the title of the currently loaded site.
|
the object on which the signal is emitted Returns: the current page title as a string |
|
user data set when the signal handler was connected. |
"lock-clicked"
signalvoid user_function (EphyLocationEntry *entry,
gpointer user_data) : Run First
Emitted when the user clicks the security icon inside the EphyLocationEntry.
|
the object on which the signal is emitted |
|
user data set when the signal handler was connected. |
"user-changed"
signalvoid user_function (EphyLocationEntry *entry,
gpointer user_data) : Run First
Emitted when the user changes the contents of the internal GtkEntry
|
the object on which the signal is emitted |
|
user data set when the signal handler was connected. |