gi-atk-2.0.24: Atk bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.Atk.Objects.Hyperlink

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.

Synopsis

Exported types

newtype Hyperlink Source #

Memory-managed wrapper type.

Instances

class (GObject o, IsDescendantOf Hyperlink o) => IsHyperlink o Source #

Type class for types which can be safely cast to Hyperlink, for instance with toHyperlink.

Instances

toHyperlink :: (MonadIO m, IsHyperlink o) => o -> m Hyperlink Source #

Cast to Hyperlink, for types for which this is known to be safe. For general casts, use castTo.

Methods

getEndIndex

hyperlinkGetEndIndex Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> m Int32

Returns: the index with the hypertext document at which this link ends

Gets the index with the hypertext document at which this link ends.

getNAnchors

hyperlinkGetNAnchors Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> m Int32

Returns: the number of anchors associated with this hyperlink

Gets the number of anchors associated with this hyperlink.

getObject

hyperlinkGetObject Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> Int32

i: a (zero-index) integer specifying the desired anchor

-> m Object

Returns: an Object associated with this hyperlinks i-th anchor

Returns the item associated with this hyperlinks nth anchor. For instance, the returned Object will implement Text if link_ is a text hyperlink, Image if link_ is an image hyperlink etc.

Multiple anchors are primarily used by client-side image maps.

getStartIndex

hyperlinkGetStartIndex Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> m Int32

Returns: the index with the hypertext document at which this link begins

Gets the index with the hypertext document at which this link begins.

getUri

hyperlinkGetUri Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> Int32

i: a (zero-index) integer specifying the desired anchor

-> m Text

Returns: a string specifying the URI

Get a the URI associated with the anchor specified by i of link_.

Multiple anchors are primarily used by client-side image maps.

isInline

hyperlinkIsInline Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> m Bool

Returns: whether or not this link displays its content inline.

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.

isSelectedLink

hyperlinkIsSelectedLink Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> m Bool

Returns: True if the AtkHyperlink is selected, False otherwise

Deprecated: (Since version 1.8)Please use ATK_STATE_FOCUSABLE for all links,and ATK_STATE_FOCUSED for focused links.

Determines whether this AtkHyperlink is selected

Since: 1.4

isValid

hyperlinkIsValid Source #

Arguments

:: (HasCallStack, MonadIO m, IsHyperlink a) 
=> a

link_: an Hyperlink

-> m Bool

Returns: whether or not this link is still valid

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.

Properties

endIndex

No description available in the introspection data.

getHyperlinkEndIndex :: (MonadIO m, IsHyperlink o) => o -> m Int32 Source #

Get the value of the “end-index” property. When overloading is enabled, this is equivalent to

get hyperlink #endIndex

numberOfAnchors

No description available in the introspection data.

getHyperlinkNumberOfAnchors :: (MonadIO m, IsHyperlink o) => o -> m Int32 Source #

Get the value of the “number-of-anchors” property. When overloading is enabled, this is equivalent to

get hyperlink #numberOfAnchors

selectedLink

Selected link

getHyperlinkSelectedLink :: (MonadIO m, IsHyperlink o) => o -> m Bool Source #

Get the value of the “selected-link” property. When overloading is enabled, this is equivalent to

get hyperlink #selectedLink

startIndex

No description available in the introspection data.

getHyperlinkStartIndex :: (MonadIO m, IsHyperlink o) => o -> m Int32 Source #

Get the value of the “start-index” property. When overloading is enabled, this is equivalent to

get hyperlink #startIndex

Signals

linkActivated

type HyperlinkLinkActivatedCallback = IO () Source #

The signal link-activated is emitted when a link is activated.

afterHyperlinkLinkActivated :: (IsHyperlink a, MonadIO m) => a -> ((?self :: a) => HyperlinkLinkActivatedCallback) -> m SignalHandlerId Source #

Connect a signal handler for the linkActivated signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after hyperlink #linkActivated callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onHyperlinkLinkActivated :: (IsHyperlink a, MonadIO m) => a -> ((?self :: a) => HyperlinkLinkActivatedCallback) -> m SignalHandlerId Source #

Connect a signal handler for the linkActivated signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on hyperlink #linkActivated callback