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.Interfaces.Hypertext

Description

An interface used for objects which implement linking between multiple resource or content locations, or multiple 'markers' within a single document. A Hypertext instance is associated with one or more Hyperlinks, which are associated with particular offsets within the Hypertext's included content. While this interface is derived from Text, there is no requirement that Hypertext instances have textual content; they may implement Image as well, and Hyperlinks need not have non-zero text offsets.

Synopsis

Exported types

newtype Hypertext Source #

Memory-managed wrapper type.

class (GObject o, IsDescendantOf Hypertext o) => IsHypertext o Source #

Type class for types which can be safely cast to Hypertext, for instance with toHypertext.

Instances

Instances details
(GObject o, IsDescendantOf Hypertext o) => IsHypertext o Source # 
Instance details

Defined in GI.Atk.Interfaces.Hypertext

toHypertext :: (MonadIO m, IsHypertext o) => o -> m Hypertext Source #

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

Methods

getLink

hypertextGetLink Source #

Arguments

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

hypertext: an Hypertext

-> Int32

linkIndex: an integer specifying the desired link

-> m Hyperlink

Returns: the link in this hypertext document at index linkIndex

Gets the link in this hypertext document at index linkIndex

getLinkIndex

hypertextGetLinkIndex Source #

Arguments

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

hypertext: an Hypertext

-> Int32

charIndex: a character index

-> m Int32

Returns: an index into the array of hyperlinks in hypertext, or -1 if there is no hyperlink associated with this character.

Gets the index into the array of hyperlinks that is associated with the character specified by charIndex.

getNLinks

hypertextGetNLinks Source #

Arguments

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

hypertext: an Hypertext

-> m Int32

Returns: the number of links within this hypertext document

Gets the number of links within this hypertext document.

Signals

linkSelected

type HypertextLinkSelectedCallback Source #

Arguments

 = Int32

arg1: the index of the hyperlink which is selected

-> IO () 

The "link-selected" signal is emitted by an AtkHyperText object when one of the hyperlinks associated with the object is selected.

afterHypertextLinkSelected :: (IsHypertext a, MonadIO m) => a -> ((?self :: a) => HypertextLinkSelectedCallback) -> m SignalHandlerId Source #

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

after hypertext #linkSelected 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.

onHypertextLinkSelected :: (IsHypertext a, MonadIO m) => a -> ((?self :: a) => HypertextLinkSelectedCallback) -> m SignalHandlerId Source #

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

on hypertext #linkSelected callback