![]() |
![]() |
![]() |
Epiphany Reference Manual | ![]() |
---|---|---|---|---|
EphyTab; EphyTab* ephy_tab_new (void); EphyEmbed* ephy_tab_get_embed (EphyTab *tab); EphyTab* ephy_tab_for_embed (EphyEmbed *embed); const char* ephy_tab_get_icon_address (EphyTab *tab); EphyEmbedSecurityLevel ephy_tab_get_security_level (EphyTab *tab); const char* ephy_tab_get_title (EphyTab *tab); float ephy_tab_get_zoom (EphyTab *tab); gboolean ephy_tab_get_load_status (EphyTab *tab); int ephy_tab_get_load_percent (EphyTab *tab); const char* ephy_tab_get_link_message (EphyTab *tab); const char* ephy_tab_get_status_message (EphyTab *tab);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----EphyTab
"address" gchararray : Read "document-type" EphyEmbedDocumentType : Read "hidden-popup-count" gint : Read "icon" GdkPixbuf : Read "icon-address" gchararray : Read / Write "load-progress" gint : Read "load-status" gboolean : Read "message" gchararray : Read "navigation" EphyTabNavigationFlags : Read "popups-allowed" gboolean : Read / Write "security-level" EphyEmbedSecurityLevel : Read "title" gchararray : Read "typed-address" gchararray : Read / Write "visibility" gboolean : Read "zoom" gfloat : Read
Each EphyWindow contains a GtkNotebook which holds one or more EphyTab:s. An EphyTab is basically a container for an EphyEmbed.
To retrieve an EphyTab's parent EphyWindow, use gtk_widget_get_toplevel().
EphyTab* ephy_tab_new (void);
Equivalent to g_object_new(), but returns an EphyTab so you don't have to cast it.
Returns : | a new EphyTab |
EphyTab* ephy_tab_for_embed (EphyEmbed *embed);
Returns the EphyTab which holds embed.
const char* ephy_tab_get_icon_address (EphyTab *tab);
Returns a URL which points to tab's site icon.
tab : | an EphyTab |
Returns : | the URL of tab's site icon |
EphyEmbedSecurityLevel ephy_tab_get_security_level (EphyTab *tab);
Returns the security level of the webpage loaded in tab.
tab : | an EphyTab |
Returns : | tab's loaded page's security level |
const char* ephy_tab_get_title (EphyTab *tab);
Returns the title of the web page loaded in tab.
float ephy_tab_get_zoom (EphyTab *tab);
Returns the zoom level of the web page loaded in tab. A return value of 1.0 corresponds to 100% zoom (normal size).
tab : | an EphyTab |
Returns : | tab's loaded page's zoom level |
gboolean ephy_tab_get_load_status (EphyTab *tab);
Returns whether the web page in tab has finished loading. A web page is only finished loading after all images, styles, and other dependencies have been downloaded and rendered.
tab : | an EphyTab |
Returns : | TRUE if the page is still loading, FALSE if complete |
int ephy_tab_get_load_percent (EphyTab *tab);
Returns the page load percentage (displayed in the progressbar).
tab : | an EphyTab |
Returns : | a percentage from 0 to 100. |
const char* ephy_tab_get_link_message (EphyTab *tab);
Returns the message displayed in tab's EphyWindow's EphyStatusbar when the user hovers the mouse over a hyperlink.
The message returned has a limited lifetime, and so should be copied with g_strdup() if it must be stored.
Listen to the "link_message" signal on the tab's EphyEmbed to be notified when the link message changes.
tab : | an EphyTab |
Returns : | The current link statusbar message |
const char* ephy_tab_get_status_message (EphyTab *tab);
Returns the message displayed in tab's EphyWindow's EphyStatusbar. If the user is hovering the mouse over a hyperlink, this function will return the same value as ephy_tab_get_link_message(). Otherwise, it will return a network status message, or NULL.
The message returned has a limited lifetime, and so should be copied with g_strdup() if it must be stored.
Listen to "notify::message" to be notified when the message property changes.
tab : | an EphyTab |
Returns : | The current statusbar message |
"document-type" EphyEmbedDocumentType : Read
The tab's documen type.
Default value: EPHY_EMBED_DOCUMENT_HTML
"hidden-popup-count" gint : Read
The tab's number of blocked popup windows.
Allowed values: >= 0
Default value: 0
"icon-address" gchararray : Read / Write
The tab icon's address.
Default value: NULL
"load-progress" gint : Read
The tab's load progress in percent.
Allowed values: [0,100]
Default value: 0
"load-status" gboolean : Read
The tab's load status.
Default value: FALSE
"popups-allowed" gboolean : Read / Write
Whether popup windows are to be displayed.
Default value: FALSE
"security-level" EphyEmbedSecurityLevel : Read
The tab's security level.
Default value: EPHY_EMBED_STATE_IS_UNKNOWN
"typed-address" gchararray : Read / Write
The typed address.
Default value: ""