![]() | ![]() | ![]() | Epiphany Reference Manual | ![]() |
---|
EphyTab — Represents an Epiphany tab
struct 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); const char* ephy_tab_get_location (EphyTab *tab); EmbedSecurityLevel 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);
"address" gchararray : Read / Write "hidden-popup-count" gint : Read "icon" gchararray : Read "load-progress" gint : Read "load-status" gboolean : Read "message" gchararray : Read "navigation" gint : Read "popups-allowed" gboolean : Read / Write "security-level" gint : Read "title" gchararray : Read "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 favicon.
tab : | an EphyTab |
Returns : | a URL to tab's favicon |
const char* ephy_tab_get_location (EphyTab *tab);
Returns the text that tab's EphyWindow will display in its location toolbar entry when tab is selected.
This is not guaranteed to be the same as tab's EphyEmbed's location, available through ephy_embed_get_location(). As the user types a new address into the location entry, ephy_tab_get_location()'s returned string will change.
tab : | an EphyTab |
Returns : | tab's EphyWindow's location entry when tab is selected |
EmbedSecurityLevel 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.
tab : | an EphyTab |
Returns : | tab's loaded web page's title |
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 |
<< EphyWindow | EphyEmbed >> |