![]() |
![]() |
![]() |
Epiphany Reference Manual | ![]() |
---|
EphyTabEphyTab — Represents an Epiphany tab |
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);
"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
.
tab : |
an EphyTab |
Returns : | tab 's loaded web page's title. Will never be NULL .
|
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
" property"document-type" EphyEmbedDocumentType : Read
The tab's documen type.
Default value: EPHY_EMBED_DOCUMENT_HTML
hidden-popup-count
" property"hidden-popup-count" gint : Read
The tab's number of blocked popup windows.
Allowed values: >= 0
Default value: 0
icon-address
" property"icon-address" gchararray : Read / Write
The tab icon's address.
Default value: NULL
load-progress
" property"load-progress" gint : Read
The tab's load progress in percent.
Allowed values: [0,100]
Default value: 0
load-status
" property"load-status" gboolean : Read
The tab's load status.
Default value: FALSE
popups-allowed
" property"popups-allowed" gboolean : Read / Write
Whether popup windows are to be displayed.
Default value: FALSE
security-level
" property"security-level" EphyEmbedSecurityLevel : Read
The tab's security level.
Default value: EPHY_EMBED_STATE_IS_UNKNOWN
typed-address
" property"typed-address" gchararray : Read / Write
The typed address.
Default value: ""
<< EphyWindow | EphyEmbed >> |