|  |  |  | 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. | 
struct 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.
struct 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. [transfer none] | 
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. |