AtkHyperlink

AtkHyperlink — An ATK object which encapsulates a link or set of links in a hypertext document.

Functions

Properties

Signals

Types and Values

Object Hierarchy

    GFlags
    ╰── AtkHyperlinkStateFlags
    GObject
    ╰── AtkHyperlink

Implemented Interfaces

AtkHyperlink implements AtkAction.

Includes

#include <atk/atk.h>

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.

Parameters

link_

an AtkHyperlink

 

i

a (zero-index) integer specifying the desired anchor

 

Returns

a string specifying the URI


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.

Parameters

link_

an AtkHyperlink

 

i

a (zero-index) integer specifying the desired anchor

 

Returns

an AtkObject associated with this hyperlinks i-th anchor.

[transfer none]


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.

Parameters

link_

an AtkHyperlink

 

Returns

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.

Parameters

link_

an AtkHyperlink

 

Returns

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.

Parameters

link_

an AtkHyperlink

 

Returns

whether or not this link is still valid


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.

Parameters

link_

an AtkHyperlink

 

Returns

whether or not this link displays its content inline.


atk_hyperlink_get_n_anchors ()

gint
atk_hyperlink_get_n_anchors (AtkHyperlink *link_);

Gets the number of anchors associated with this hyperlink.

Parameters

link_

an AtkHyperlink

 

Returns

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

Parameters

link_

an AtkHyperlink

 

Returns

True if the AtkHyperlink is selected, False otherwise

Since: 1.4

Types and Values

struct AtkHyperlink

struct AtkHyperlink;

enum AtkHyperlinkStateFlags

Describes the type of link

Members

ATK_HYPERLINK_IS_INLINE

Link is inline

 

Property Details

The “end-index” property

  “end-index”                int

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”        int

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


The “start-index” property

  “start-index”              int

The start index of the AtkHyperlink object.

Owner: AtkHyperlink

Flags: Read

Allowed values: >= 0

Default value: 0

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