Top |
AtkHyperlinkAtkHyperlink — An ATK object which encapsulates a link or set of links in a hypertext document. |
Functions
gchar * | atk_hyperlink_get_uri () |
AtkObject * | atk_hyperlink_get_object () |
gint | atk_hyperlink_get_end_index () |
gint | atk_hyperlink_get_start_index () |
gboolean | atk_hyperlink_is_valid () |
gboolean | atk_hyperlink_is_inline () |
gint | atk_hyperlink_get_n_anchors () |
gboolean | atk_hyperlink_is_selected_link () |
Properties
gint | end-index | Read |
gint | number-of-anchors | Read |
gboolean | selected-link | Read |
gint | start-index | Read |
Description
An ATK object which encapsulates a link or set of links (for instance in the case of client-side image maps) in a hypertext document. It may implement the AtkAction interface. AtkHyperlink may also be used to refer to inline embedded content, since it allows specification of a start and end offset within the host AtkHypertext object.
Functions
atk_hyperlink_get_uri ()
gchar * atk_hyperlink_get_uri (AtkHyperlink *link_
,gint i
);
Get a the URI associated with the anchor specified
by i
of link_
.
Multiple anchors are primarily used by client-side image maps.
atk_hyperlink_get_object ()
AtkObject * atk_hyperlink_get_object (AtkHyperlink *link_
,gint i
);
Returns the item associated with this hyperlinks nth anchor.
For instance, the returned AtkObject will implement AtkText
if link_
is a text hyperlink, AtkImage if link_
is an image
hyperlink etc.
Multiple anchors are primarily used by client-side image maps.
atk_hyperlink_get_end_index ()
gint
atk_hyperlink_get_end_index (AtkHyperlink *link_
);
Gets the index with the hypertext document at which this link ends.
atk_hyperlink_get_start_index ()
gint
atk_hyperlink_get_start_index (AtkHyperlink *link_
);
Gets the index with the hypertext document at which this link begins.
atk_hyperlink_is_valid ()
gboolean
atk_hyperlink_is_valid (AtkHyperlink *link_
);
Since the document that a link is associated with may have changed
this method returns TRUE
if the link is still valid (with
respect to the document it references) and FALSE
otherwise.
atk_hyperlink_is_inline ()
gboolean
atk_hyperlink_is_inline (AtkHyperlink *link_
);
Indicates whether the link currently displays some or all of its
content inline. Ordinary HTML links will usually return
FALSE
, but an inline <src> HTML element will return
TRUE
.
atk_hyperlink_get_n_anchors ()
gint
atk_hyperlink_get_n_anchors (AtkHyperlink *link_
);
Gets the number of anchors associated with this hyperlink.
atk_hyperlink_is_selected_link ()
gboolean
atk_hyperlink_is_selected_link (AtkHyperlink *link_
);
atk_hyperlink_is_selected_link
has been deprecated since version 1.8 and should not be used in newly-written code.
Please use ATK_STATE_FOCUSABLE for all links, and ATK_STATE_FOCUSED for focused links.
Determines whether this AtkHyperlink is selected
Since: 1.4
Property Details
The “end-index”
property
“end-index” gint
The end index of the AtkHyperlink object.
Owner: AtkHyperlink
Flags: Read
Allowed values: >= 0
Default value: 0
The “number-of-anchors”
property
“number-of-anchors” gint
The number of anchors associated with the AtkHyperlink object.
Owner: AtkHyperlink
Flags: Read
Allowed values: >= 0
Default value: 0
The “selected-link”
property
“selected-link” gboolean
Selected link
AtkHyperlink:selected-link
has been deprecated since version 1.8 and should not be used in newly-written code.
Please use ATK_STATE_FOCUSABLE for all links, and ATK_STATE_FOCUSED for focused links.
Owner: AtkHyperlink
Flags: Read
Default value: FALSE
Signal Details
The “link-activated”
signal
void user_function (AtkHyperlink *atkhyperlink, gpointer user_data)
The signal link-activated is emitted when a link is activated.
Parameters
atkhyperlink |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last