From 1a84ef9f76056a2805a837bb45209a3746cdb521 Mon Sep 17 00:00:00 2001 From: Adam Hooper Date: Thu, 25 Mar 2004 19:09:44 +0000 Subject: Documented EphyEmbed --- doc/reference/Makefile.am | 4 +- doc/reference/epiphany-docs.sgml | 1 + doc/reference/epiphany-sections.txt | 80 ++++- doc/reference/epiphany.types | 2 + doc/reference/tmpl/ephy-embed.sgml | 515 ++++++++++++++++++++++++++++++++ doc/reference/tmpl/ephy-tab.sgml | 9 - doc/reference/tmpl/epiphany-unused.sgml | 22 ++ 7 files changed, 621 insertions(+), 12 deletions(-) create mode 100644 doc/reference/tmpl/ephy-embed.sgml (limited to 'doc/reference') diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am index c1026de81..cf981f0b6 100644 --- a/doc/reference/Makefile.am +++ b/doc/reference/Makefile.am @@ -1,6 +1,9 @@ ## Process this file with automake to produce Makefile.in AUTOMAKE_OPTIONS = 1.6 +INCLUDES = $(MOZILLA_COMPONENT_CFLAGS) \ + -include $(MOZILLA_INCLUDE_ROOT)/mozilla-config.h + # The name of the module DOC_MODULE=epiphany @@ -66,7 +69,6 @@ IGNORE_HFILES = \ ephy-download.h \ ephy-embed-dialog.h \ ephy-embed-event.h \ - ephy-embed.h \ ephy-embed-persist.h \ ephy-embed-popup-control.h \ ephy-embed-prefs.h \ diff --git a/doc/reference/epiphany-docs.sgml b/doc/reference/epiphany-docs.sgml index 7adab1ca0..92185ba87 100644 --- a/doc/reference/epiphany-docs.sgml +++ b/doc/reference/epiphany-docs.sgml @@ -11,6 +11,7 @@ + Incomplete diff --git a/doc/reference/epiphany-sections.txt b/doc/reference/epiphany-sections.txt index f77ba5439..5d6d8bda3 100644 --- a/doc/reference/epiphany-sections.txt +++ b/doc/reference/epiphany-sections.txt @@ -10,6 +10,16 @@ ephy_permission_manager_remove ephy_permission_manager_clear ephy_permission_manager_test ephy_permission_manager_list + +EPHY_PERMISSION_MANAGER +EPHY_IS_PERMISSION_MANAGER +EPHY_TYPE_PERMISSION_MANAGER +EPHY_TYPE_PERMISSION_INFO +ephy_permission_info_get_type +EPHY_PERMISSION_MANAGER_GET_IFACE +EPHY_IS_PERMISSION_MANAGER_IFACE +EPHY_PERMISSION_MANAGER_IFACE +ephy_permission_manager_get_type
@@ -18,7 +28,6 @@ ephy_permission_manager_list EphyWindow ephy_window_new ephy_window_new_with_chrome - ephy_window_get_notebook ephy_window_add_tab ephy_window_remove_tab @@ -34,6 +43,14 @@ ephy_window_set_print_preview ephy_window_set_zoom ephy_window_activate_location ephy_window_load_url + +EPHY_WINDOW +EPHY_IS_WINDOW +EPHY_TYPE_WINDOW +ephy_window_get_type +EPHY_WINDOW_CLASS +EPHY_IS_WINDOW_CLASS +EPHY_WINDOW_GET_CLASS
@@ -41,7 +58,6 @@ ephy_window_load_url EphyTab EphyTab ephy_tab_new -ephy_tab_get_window ephy_tab_get_embed ephy_tab_for_embed ephy_tab_get_icon_address @@ -53,8 +69,68 @@ ephy_tab_get_load_status ephy_tab_get_load_percent ephy_tab_get_link_message ephy_tab_get_status_message + +EPHY_TAB +EPHY_IS_TAB +EPHY_TYPE_TAB +ephy_tab_get_type +EPHY_TAB_CLASS +EPHY_IS_TAB_CLASS +EPHY_TAB_GET_CLASS
+
+ephy-embed +EphyEmbed +EphyEmbed +EphyEmbedIface +EmbedState +EphyEmbedChrome +EmbedReloadFlags +EmbedPrintPreviewNavType +EmbedSecurityLevel +ephy_embed_load_url +ephy_embed_stop_load +ephy_embed_reload +ephy_embed_get_title +ephy_embed_get_location +ephy_embed_get_link_message +ephy_embed_get_js_status +ephy_embed_can_go_back +ephy_embed_can_go_forward +ephy_embed_can_go_up +ephy_embed_get_go_up_list +ephy_embed_go_back +ephy_embed_go_forward +ephy_embed_go_up +ephy_embed_shistory_n_items +ephy_embed_shistory_get_nth +ephy_embed_shistory_get_pos +ephy_embed_shistory_go_nth +ephy_embed_get_security_level +ephy_embed_set_zoom +ephy_embed_get_zoom +ephy_embed_find_set_properties +ephy_embed_find_next +ephy_embed_set_encoding +ephy_embed_get_encoding_info +ephy_embed_print +ephy_embed_print_preview_close +ephy_embed_print_preview_n_pages +ephy_embed_print_preview_navigate +ephy_embed_activate +ephy_embed_has_modified_forms + +ephy_embed_get_type +EPHY_EMBED +EPHY_IS_EMBED +EPHY_TYPE_EMBED +ephy_embed_chrome_get_type +EPHY_EMBED_GET_IFACE +EPHY_EMBED_IFACE +EPHY_IS_EMBED_IFACE +EPHY_TYPE_EMBED_CHROME_MASK +
diff --git a/doc/reference/epiphany.types b/doc/reference/epiphany.types index 69a003fff..dffbaa6f0 100644 --- a/doc/reference/epiphany.types +++ b/doc/reference/epiphany.types @@ -29,6 +29,7 @@ ephy_cell_renderer_progress_get_type #include #include #include +#include ephy_embed_get_type downloader_view_get_type @@ -41,6 +42,7 @@ ephy_embed_single_get_type ephy_cookie_manager_get_type ephy_permission_manager_get_type ephy_password_manager_get_type +mozilla_embed_get_type #include #include diff --git a/doc/reference/tmpl/ephy-embed.sgml b/doc/reference/tmpl/ephy-embed.sgml new file mode 100644 index 000000000..c57e5cf98 --- /dev/null +++ b/doc/reference/tmpl/ephy-embed.sgml @@ -0,0 +1,515 @@ + +EphyEmbed + + +An interface to the widget displaying web pages + + + +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. + + +#EphyEmbed's most important functions can be divided into sets: + + +Functions which affect navigation +Functions which return information about the displayed web +page +Functions which manipulate the session history + +The first two sets of functions are self-explanitory. +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. + + + +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). + + + + + + + + + + + + + +@base_iface: +@context_menu: +@favicon: +@location: +@net_state: +@new_window: +@dom_mouse_click: +@dom_mouse_down: +@popup_blocked: +@security_change: +@zoom_change: +@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: +@set_zoom: +@get_zoom: +@find_set_properties: +@find_next: +@set_encoding: +@get_encoding_info: +@print: +@print_preview_close: +@print_preview_n_pages: +@print_preview_navigate: +@activate: +@has_modified_forms: + + + +Represents the state of an #EphyEmbed with regards to networking negotiations. + + +@EMBED_STATE_UNKNOWN: +@EMBED_STATE_START: +@EMBED_STATE_REDIRECTING: +@EMBED_STATE_TRANSFERRING: +@EMBED_STATE_NEGOTIATING: +@EMBED_STATE_STOP: +@EMBED_STATE_IS_REQUEST: +@EMBED_STATE_IS_DOCUMENT: +@EMBED_STATE_IS_NETWORK: +@EMBED_STATE_IS_WINDOW: + + + +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. + + +@EPHY_EMBED_CHROME_DEFAULT: +@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. + + + + + + +@EMBED_RELOAD_NORMAL: +@EMBED_RELOAD_FORCE: Bypass cache and proxy while reloading a web page + + + +Specifies the action to perform in ephy_embed_print_preview_navigate(). + + +@PRINTPREVIEW_GOTO_PAGENUM: +@PRINTPREVIEW_PREV_PAGE: +@PRINTPREVIEW_NEXT_PAGE: +@PRINTPREVIEW_HOME: +@PRINTPREVIEW_END: + + + +Represents the security status of an #EphyEmbed. For example, a page with an +invalid SSL certificate will have an #EmbedSecurityLevel of %STATE_IS_BROKEN. + + +@STATE_IS_UNKNOWN: +@STATE_IS_INSECURE: +@STATE_IS_BROKEN: +@STATE_IS_SECURE_MED: +@STATE_IS_SECURE_LOW: +@STATE_IS_SECURE_HIGH: + + + + + + +@embed: +@url: + + + + + + + +@embed: + + + + + + + +@embed: +@flags: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@toplevel: +@Returns: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: + + + + + + + +@embed: + + + + + + + +@embed: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@nth: +@is_relative: +@url: +@title: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@nth: + + + + + + + +@embed: +@level: +@description: + + + + + + + +@embed: +@zoom: +@reflow: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@search_string: +@case_sensitive: +@wrap_around: + + + + + + + +@embed: +@backwards: +@Returns: + + + + + + + +@embed: +@encoding: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@info: + + + + + + + +@embed: + + + + + + + +@embed: +@Returns: + + + + + + + +@embed: +@type: +@page: + + + + + + + +@embed: + + + + + + + +@embed: +@Returns: + + + + + + + +@ephyembed: the object which received the signal. +@arg1: +@Returns: + + + + + + +@ephyembed: the object which received the signal. +@arg1: +@Returns: + + + + + + +@ephyembed: the object which received the signal. +@arg1: +@Returns: + + + + + + +@ephyembed: the object which received the signal. +@arg1: + + + + + + +@ephyembed: the object which received the signal. +@arg1: + + + + + + +@ephyembed: the object which received the signal. +@arg1: +@arg2: + + + + + + +@ephyembed: the object which received the signal. +@arg1: +@arg2: + + + + + + +@ephyembed: the object which received the signal. +@arg1: + + + + + + +@ephyembed: the object which received the signal. +@arg1: + diff --git a/doc/reference/tmpl/ephy-tab.sgml b/doc/reference/tmpl/ephy-tab.sgml index c598e77a8..94d71bb1f 100644 --- a/doc/reference/tmpl/ephy-tab.sgml +++ b/doc/reference/tmpl/ephy-tab.sgml @@ -29,15 +29,6 @@ An #EphyTab is basically a container for an #EphyEmbed. @Returns: - - - - - -@tab: -@Returns: - - diff --git a/doc/reference/tmpl/epiphany-unused.sgml b/doc/reference/tmpl/epiphany-unused.sgml index c984df54a..5fcda58b0 100644 --- a/doc/reference/tmpl/epiphany-unused.sgml +++ b/doc/reference/tmpl/epiphany-unused.sgml @@ -24,6 +24,20 @@ mozilla-embed-event + + + + + +@ephyembed: the object which received the signal. + + + + + + +@Returns: + @@ -33,6 +47,14 @@ mozilla-embed-event @path: @gs: + + + + + +@tab: +@Returns: + -- cgit v1.2.3