gi-atk
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellNone
LanguageHaskell2010

GI.Atk.Objects.Hyperlink

Description

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

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

type family ResolveHyperlinkMethod (t :: Symbol) o where ... Source #

Equations

ResolveHyperlinkMethod "bindProperty" o = ObjectBindPropertyMethodInfo 
ResolveHyperlinkMethod "bindPropertyFull" o = ObjectBindPropertyFullMethodInfo 
ResolveHyperlinkMethod "doAction" o = ActionDoActionMethodInfo 
ResolveHyperlinkMethod "forceFloating" o = ObjectForceFloatingMethodInfo 
ResolveHyperlinkMethod "freezeNotify" o = ObjectFreezeNotifyMethodInfo 
ResolveHyperlinkMethod "getv" o = ObjectGetvMethodInfo 
ResolveHyperlinkMethod "isFloating" o = ObjectIsFloatingMethodInfo 
ResolveHyperlinkMethod "isInline" o = HyperlinkIsInlineMethodInfo 
ResolveHyperlinkMethod "isSelectedLink" o = HyperlinkIsSelectedLinkMethodInfo 
ResolveHyperlinkMethod "isValid" o = HyperlinkIsValidMethodInfo 
ResolveHyperlinkMethod "notify" o = ObjectNotifyMethodInfo 
ResolveHyperlinkMethod "notifyByPspec" o = ObjectNotifyByPspecMethodInfo 
ResolveHyperlinkMethod "ref" o = ObjectRefMethodInfo 
ResolveHyperlinkMethod "refSink" o = ObjectRefSinkMethodInfo 
ResolveHyperlinkMethod "runDispose" o = ObjectRunDisposeMethodInfo 
ResolveHyperlinkMethod "stealData" o = ObjectStealDataMethodInfo 
ResolveHyperlinkMethod "stealQdata" o = ObjectStealQdataMethodInfo 
ResolveHyperlinkMethod "thawNotify" o = ObjectThawNotifyMethodInfo 
ResolveHyperlinkMethod "unref" o = ObjectUnrefMethodInfo 
ResolveHyperlinkMethod "watchClosure" o = ObjectWatchClosureMethodInfo 
ResolveHyperlinkMethod "getData" o = ObjectGetDataMethodInfo 
ResolveHyperlinkMethod "getDescription" o = ActionGetDescriptionMethodInfo 
ResolveHyperlinkMethod "getEndIndex" o = HyperlinkGetEndIndexMethodInfo 
ResolveHyperlinkMethod "getKeybinding" o = ActionGetKeybindingMethodInfo 
ResolveHyperlinkMethod "getLocalizedName" o = ActionGetLocalizedNameMethodInfo 
ResolveHyperlinkMethod "getNActions" o = ActionGetNActionsMethodInfo 
ResolveHyperlinkMethod "getNAnchors" o = HyperlinkGetNAnchorsMethodInfo 
ResolveHyperlinkMethod "getName" o = ActionGetNameMethodInfo 
ResolveHyperlinkMethod "getObject" o = HyperlinkGetObjectMethodInfo 
ResolveHyperlinkMethod "getProperty" o = ObjectGetPropertyMethodInfo 
ResolveHyperlinkMethod "getQdata" o = ObjectGetQdataMethodInfo 
ResolveHyperlinkMethod "getStartIndex" o = HyperlinkGetStartIndexMethodInfo 
ResolveHyperlinkMethod "getUri" o = HyperlinkGetUriMethodInfo 
ResolveHyperlinkMethod "setData" o = ObjectSetDataMethodInfo 
ResolveHyperlinkMethod "setDataFull" o = ObjectSetDataFullMethodInfo 
ResolveHyperlinkMethod "setDescription" o = ActionSetDescriptionMethodInfo 
ResolveHyperlinkMethod "setProperty" o = ObjectSetPropertyMethodInfo 
ResolveHyperlinkMethod l o = MethodResolutionFailed l o :: Type 

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

data HyperlinkGetObjectMethodInfo Source #

Instances

Instances details
(signature ~ (Int32 -> m Object), MonadIO m, IsHyperlink a) => OverloadedMethod HyperlinkGetObjectMethodInfo a signature Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

Methods

overloadedMethod :: a -> signature #

OverloadedMethodInfo HyperlinkGetObjectMethodInfo (a :: Type) Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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

data HyperlinkGetUriMethodInfo Source #

Instances

Instances details
(signature ~ (Int32 -> m Text), MonadIO m, IsHyperlink a) => OverloadedMethod HyperlinkGetUriMethodInfo a signature Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

Methods

overloadedMethod :: a -> signature #

OverloadedMethodInfo HyperlinkGetUriMethodInfo (a :: Type) Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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

data HyperlinkIsInlineMethodInfo Source #

Instances

Instances details
(signature ~ m Bool, MonadIO m, IsHyperlink a) => OverloadedMethod HyperlinkIsInlineMethodInfo a signature Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

Methods

overloadedMethod :: a -> signature #

OverloadedMethodInfo HyperlinkIsInlineMethodInfo (a :: Type) Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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

data HyperlinkIsValidMethodInfo Source #

Instances

Instances details
(signature ~ m Bool, MonadIO m, IsHyperlink a) => OverloadedMethod HyperlinkIsValidMethodInfo a signature Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

Methods

overloadedMethod :: a -> signature #

OverloadedMethodInfo HyperlinkIsValidMethodInfo (a :: Type) Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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.

data HyperlinkEndIndexPropertyInfo Source #

Instances

Instances details
AttrInfo HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrAllowedOps HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrBaseTypeConstraint HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrGetType HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrLabel HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrOrigin HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrSetTypeConstraint HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferType HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferTypeConstraint HyperlinkEndIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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.

data HyperlinkNumberOfAnchorsPropertyInfo Source #

Instances

Instances details
AttrInfo HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrAllowedOps HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrBaseTypeConstraint HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrGetType HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrLabel HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrOrigin HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrSetTypeConstraint HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferType HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferTypeConstraint HyperlinkNumberOfAnchorsPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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

data HyperlinkSelectedLinkPropertyInfo Source #

Instances

Instances details
AttrInfo HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrAllowedOps HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrBaseTypeConstraint HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrGetType HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrLabel HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrOrigin HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrSetTypeConstraint HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferType HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferTypeConstraint HyperlinkSelectedLinkPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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.

data HyperlinkStartIndexPropertyInfo Source #

Instances

Instances details
AttrInfo HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrAllowedOps HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrBaseTypeConstraint HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrGetType HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrLabel HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrOrigin HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrSetTypeConstraint HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferType HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

type AttrTransferTypeConstraint HyperlinkStartIndexPropertyInfo Source # 
Instance details

Defined in GI.Atk.Objects.Hyperlink

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