aboutsummaryrefslogblamecommitdiffstats
path: root/doc/reference/tmpl/ephy-embed.sgml
blob: 063548e5b0dda7a045c5a1fb859a1efa00151114 (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::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: 
@close_request: 
@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: 
@shistory_copy: 
@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: 
@has_modified_forms: 
@close: 

<!-- ##### 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_has_modified_forms ##### -->
<para>

</para>

@embed: 
@Returns: