blob: ac86c99cbca3bd759dd602717e4e17f2eebd5784 (
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>
<!-- ##### STRUCT EphyEmbed ##### -->
<para>
</para>
<!-- ##### SIGNAL EphyEmbed::dom-content-loaded ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::ge-content-change ##### -->
<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-location ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### 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-net-state ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
@arg2:
<!-- ##### SIGNAL EphyEmbed::ge-new-window ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- # Unused Parameters # -->
@Returns:
@arg2:
<!-- ##### SIGNAL EphyEmbed::ge-popup-blocked ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
@:
<!-- ##### SIGNAL EphyEmbed::ge-search-key-press ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@event:
@Returns:
<!-- ##### SIGNAL EphyEmbed::ge-security-change ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### SIGNAL EphyEmbed::ge-zoom-change ##### -->
<para>
</para>
@ephyembed: the object which received the signal.
@arg1:
<!-- ##### STRUCT EphyEmbedIface ##### -->
<para>
</para>
@base_iface:
@context_menu:
@favicon:
@feed_link:
@location:
@net_state:
@dom_mouse_click:
@dom_mouse_down:
@dom_content_loaded:
@popup_blocked:
@security_change:
@zoom_change:
@content_change:
@modal_alert:
@modal_alert_closed:
@document_type:
@new_window:
@search_key_press:
@load_url:
@stop_load:
@reload:
@can_go_back:
@can_go_forward:
@can_go_up:
@get_go_up_list:
@go_back:
@go_forward:
@go_up:
@get_title:
@get_location:
@get_link_message:
@get_js_status:
@shistory_n_items:
@shistory_get_nth:
@shistory_get_pos:
@shistory_go_nth:
@get_security_level:
@show_page_certificate:
@set_zoom:
@get_zoom:
@get_encoding:
@has_automatic_encoding:
@set_encoding:
@print:
@set_print_preview_mode:
@print_preview_n_pages:
@print_preview_navigate:
@activate:
@has_modified_forms:
<!-- ##### 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_stop_load ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_reload ##### -->
<para>
</para>
@embed:
@force:
<!-- # Unused Parameters # -->
@flags:
<!-- ##### 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_forward ##### -->
<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_back ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_go_forward ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_go_up ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_shistory_n_items ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_shistory_get_nth ##### -->
<para>
</para>
@embed:
@nth:
@is_relative:
@url:
@title:
<!-- ##### FUNCTION ephy_embed_shistory_get_pos ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_shistory_go_nth ##### -->
<para>
</para>
@embed:
@nth:
<!-- ##### FUNCTION ephy_embed_get_security_level ##### -->
<para>
</para>
@embed:
@level:
@description:
<!-- ##### FUNCTION ephy_embed_set_zoom ##### -->
<para>
</para>
@embed:
@zoom:
<!-- # Unused Parameters # -->
@reflow:
<!-- ##### FUNCTION ephy_embed_get_zoom ##### -->
<para>
</para>
@embed:
@Returns:
<!-- ##### FUNCTION ephy_embed_find_set_properties ##### -->
<para>
</para>
@find:
@search_string:
@case_sensitive:
<!-- # Unused Parameters # -->
@embed:
@wrap_around:
<!-- ##### FUNCTION ephy_embed_set_encoding ##### -->
<para>
</para>
@embed:
@encoding:
<!-- ##### FUNCTION ephy_embed_print ##### -->
<para>
</para>
@embed:
<!-- # Unused Parameters # -->
@info:
<!-- ##### 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_activate ##### -->
<para>
</para>
@embed:
<!-- ##### FUNCTION ephy_embed_has_modified_forms ##### -->
<para>
</para>
@embed:
@Returns:
|