blob: 1573b86b119f17cc50a86c15a703f20183aca878 (
plain) (
tree)
|
|
<!-- ##### SECTION Title ##### -->
EphyEmbed
<!-- ##### SECTION Short_Description ##### -->
An interface to the widget displaying web pages
<!-- ##### SECTION Long_Description ##### -->
<para>
Each #EphyTab contains an #EphyEmbed. An #EphyEmbed is an interface; right now
it is only implemented by #MozillaEmbed, but whenever possible, #EphyEmbed's
functions should be used instead of their #MozillaEmbed equivalents.
</para>
<para>
#EphyEmbed's most important functions can be divided into sets:
</para>
<itemizedlist>
<listitem>Functions which affect navigation</listitem>
<listitem>Functions which return information about the displayed web
page</listitem>
<listitem>Functions which manipulate the session history</listitem>
</itemizedlist>
<para>The first two sets of functions are self-explanitory.</para>
<para>The session history functions are used to traverse the embedded browser's
history. Each #EphyEmbed remembers a history of the web pages it has visited.
There can be a maximum limit, however; for #MozillaEmbed, this limit is
determined by Mozilla's browser.sessionhistory.max_entries preference. Because
of this limit, ephy_embed_shistory_n_items() will not necessarily return the
number of web pages visited in the embed's lifetime; likewise,
ephy_embed_shistory_go_nth() will not always return to the user's home page
when called with a 0 argument.</para>
<!-- ##### SECTION See_Also ##### -->
<para>
Using #EphyEmbed instead of #MozillaEmbed is good practice. However, using a
#MozillaEmbed or even a #GtkMozEmbed may be necessary in certain cases (this can
be done by casting).
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT EphyEmbed ##### -->
<para>
</para>
<!-- ##### SIGNAL EphyEmbed::close-request ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@Returns:
<!-- ##### SIGNAL EphyEmbed::content-blocked ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::dom-content-loaded ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::ge-context-menu ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@Returns:
<!-- ##### SIGNAL EphyEmbed::ge-document-type ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::ge-dom-mouse-click ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@Returns:
<!-- ##### SIGNAL EphyEmbed::ge-dom-mouse-down ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@Returns:
<!-- ##### SIGNAL EphyEmbed::ge-favicon ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::ge-feed-link ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@arg2:
@arg3:
<!-- ##### SIGNAL EphyEmbed::ge-modal-alert ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@Returns:
<!-- ##### SIGNAL EphyEmbed::ge-modal-alert-closed ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
<!-- ##### SIGNAL EphyEmbed::ge-new-window ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::ge-popup-blocked ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@arg2:
@arg3:
<!-- ##### SIGNAL EphyEmbed::ge-search-key-press ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@event:
@Returns:
<!-- ##### SIGNAL EphyEmbed::ge-search-link ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@arg2:
@arg3:
<!-- ##### SIGNAL EphyEmbed::ge-zoom-change ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::new-document-now ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@Param2:
<!-- ##### STRUCT EphyEmbedIface ##### -->
<para>
</para>
@base_iface:
@context_menu:
@favicon:
@feed_link:
@search_link:
@dom_mouse_click:
@dom_mouse_down:
@dom_content_loaded:
@popup_blocked:
@zoom_change:
@content_blocked:
@modal_alert:
@modal_alert_closed:
@document_type:
@new_window:
@search_key_press:
@close_request:
@new_document_now:
@load_url:
@load:
@reload:
@can_go_back:
@can_go_up:
@get_go_up_list:
@go_back:
@go_forward:
@go_up:
@get_title:
@get_location:
@get_link_message:
@get_js_status:
@shistory_copy:
@get_security_level:
@show_page_certificate:
@set_zoom:
@get_zoom:
@scroll_lines:
@scroll_pages:
@scroll_pixels:
@get_encoding:
@has_automatic_encoding:
@set_encoding:
@print:
@set_print_preview_mode:
@print_preview_n_pages:
@print_preview_navigate:
@has_modified_forms:
@close:
@get_document_type:
@get_load_percent:
@get_load_status:
@get_navigation_flags:
@get_typed_address:
@set_typed_address:
@get_address:
@get_status_message:
@get_icon:
@get_icon_address:
@get_is_blank:
@get_loading_title:
@get_visibility:
@get_backward_history:
@get_forward_history:
@get_next_history_item:
@get_previous_history_item:
@go_to_history_item:
<!-- ##### ENUM EphyEmbedChrome ##### -->
<para>
Determines which aspects of the user interface should be displayed. Most of the
time, an #EphyEmbed's chrome will simply be %EPHY_EMBED_CHROME_DEFAULT. However,
windows opened with JavaScript often use a nonstandard chrome.
</para>
@EPHY_EMBED_CHROME_MENUBAR: %TRUE for the #EphyEmbed's containing #EphyWindow
to display its menubar.
@EPHY_EMBED_CHROME_TOOLBAR: %TRUE for the #EphyEmbed's containing #EphyWindow
to display its toolbars.
@EPHY_EMBED_CHROME_STATUSBAR: %TRUE for the #EphyEmbed's containing #EphyWindow
to display its statusbar.
@EPHY_EMBED_CHROME_BOOKMARKSBAR:
<!-- ##### FUNCTION ephy_embed_load_url ##### -->
<para>
</para>
@embed:
@url:
<!-- ##### FUNCTION ephy_embed_get_title ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_get_location ##### -->
<para>
</para>
@embed:
@toplevel:
@Returns:
<!-- ##### FUNCTION ephy_embed_get_link_message ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_get_js_status ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_can_go_back ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_can_go_up ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_get_go_up_list ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_go_up ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_get_security_level ##### -->
<para>
</para>
@embed:
@level:
@description:
<!-- ##### FUNCTION ephy_embed_set_zoom ##### -->
<para>
</para>
@embed:
@zoom:
<!-- ##### FUNCTION ephy_embed_get_zoom ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_find_set_properties ##### -->
<para>
</para>
@find:
@search_string:
@case_sensitive:
<!-- ##### FUNCTION ephy_embed_set_encoding ##### -->
<para>
</para>
@embed:
@encoding:
<!-- ##### FUNCTION ephy_embed_print ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_print_preview_n_pages ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_print_preview_navigate ##### -->
<para>
</para>
@embed:
@type:
@page:
<!-- ##### FUNCTION ephy_embed_has_modified_forms ##### -->
<para>
</para>
@embed:
@Returns:
|
