|
|
|
ATK - Accessibility Toolkit | |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
AtkHyperlinkAtkHyperlink — An ATK object which encapsulates a link or set of links in a hypertext document. |
AtkHyperlink; enum AtkHyperlinkStateFlags; gchar* atk_hyperlink_get_uri (AtkHyperlink *link_,gint i); AtkObject* atk_hyperlink_get_object (AtkHyperlink *link_,gint i); gint atk_hyperlink_get_end_index (AtkHyperlink *link_); gint atk_hyperlink_get_start_index (AtkHyperlink *link_); gboolean atk_hyperlink_is_valid (AtkHyperlink *link_); gboolean atk_hyperlink_is_inline (AtkHyperlink *link_); gint atk_hyperlink_get_n_anchors (AtkHyperlink *link_); gboolean atk_hyperlink_is_selected_link (AtkHyperlink *link_);
"end-index" gint : Read "number-of-anchors" gint : Read "selected-link" gboolean : Read "start-index" gint : Read
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.
typedef struct _AtkHyperlink AtkHyperlink;
The AtkHyperlink structure should not be accessed directly.
typedef enum
{
ATK_HYPERLINK_IS_INLINE = 1 << 0
} AtkHyperlinkStateFlags;
Describes the type of link
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.
|
an AtkHyperlink |
|
a (zero-index) integer specifying the desired anchor |
Returns : |
a string specifying the URI |
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.
|
an AtkHyperlink |
|
a (zero-index) integer specifying the desired anchor |
Returns : |
an AtkObject associated with this hyperlinks i-th anchor |
gint atk_hyperlink_get_end_index (AtkHyperlink *link_);
Gets the index with the hypertext document at which this link ends.
|
an AtkHyperlink |
Returns : |
the index with the hypertext document at which this link ends |
gint atk_hyperlink_get_start_index (AtkHyperlink *link_);
Gets the index with the hypertext document at which this link begins.
|
an AtkHyperlink |
Returns : |
the index with the hypertext document at which this link begins |
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.
|
an AtkHyperlink |
Returns : |
whether or not this link is still valid |
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.
a *
|
an AtkHyperlink |
Returns : |
whether or not this link displays its content inline. |
gint atk_hyperlink_get_n_anchors (AtkHyperlink *link_);
Gets the number of anchors associated with this hyperlink.
|
an AtkHyperlink |
Returns : |
the number of anchors associated with this hyperlink |
gboolean atk_hyperlink_is_selected_link (AtkHyperlink *link_);
atk_hyperlink_is_selected_link is deprecated and should not be used in newly-written code. Please use ATK_STATE_SELECTED to indicate when a hyperlink within a Hypertext container is selected.
Determines whether this AtkHyperlink is selected
|
an AtkHyperlink |
Returns : |
True is the AtkHyperlink is selected, False otherwise |
Since 1.4
"end-index" property "end-index" gint : Read
The end index of the AtkHyperlink object.
Allowed values: >= 0
Default value: 0
"number-of-anchors" property "number-of-anchors" gint : Read
The number of anchors associated with the AtkHyperlink object.
Allowed values: >= 0
Default value: 0
"selected-link" property "selected-link" gboolean : Read
Specifies whether the AtkHyperlink object is selected.
Default value: FALSE
"link-activated" signalvoid user_function (AtkHyperlink *atkhyperlink, gpointer user_data) : Run Last
The signal link-activated is emitted when a link is activated.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |