gi-webkit-6.0.2: WebKit bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.WebKit.Objects.HitTestResult

Description

Result of a Hit Test.

A Hit Test is an operation to get context information about a given point in a WebView. HitTestResult represents the result of a Hit Test. It provides context information about what is at the coordinates of the Hit Test, such as if there's a link, an image or a media.

You can get the context of the HitTestResult with hitTestResultGetContext that returns a bitmask of HitTestResultContext flags. You can also use hitTestResultContextIsLink, hitTestResultContextIsImage and hitTestResultContextIsMedia to determine whether there's a link, image or a media element at the coordinates of the Hit Test. Note that it's possible that several HitTestResultContext flags are active at the same time, for example if there's a link containing an image.

When the mouse is moved over a WebView a Hit Test is performed for the mouse coordinates and WebView::mouseTargetChanged signal is emitted with a HitTestResult.

Synopsis

Exported types

newtype HitTestResult Source #

Memory-managed wrapper type.

Constructors

HitTestResult (ManagedPtr HitTestResult) 

Instances

Instances details
Eq HitTestResult Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

GObject HitTestResult Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

ManagedPtrNewtype HitTestResult Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

Methods

toManagedPtr :: HitTestResult -> ManagedPtr HitTestResult

TypedObject HitTestResult Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

Methods

glibType :: IO GType

HasParentTypes HitTestResult Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

IsGValue (Maybe HitTestResult) Source #

Convert HitTestResult to and from GValue. See toGValue and fromGValue.

Instance details

Defined in GI.WebKit.Objects.HitTestResult

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe HitTestResult -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe HitTestResult)

type ParentTypes HitTestResult Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

type ParentTypes HitTestResult = '[Object]

class (GObject o, IsDescendantOf HitTestResult o) => IsHitTestResult o Source #

Type class for types which can be safely cast to HitTestResult, for instance with toHitTestResult.

Instances

Instances details
(GObject o, IsDescendantOf HitTestResult o) => IsHitTestResult o Source # 
Instance details

Defined in GI.WebKit.Objects.HitTestResult

toHitTestResult :: (MonadIO m, IsHitTestResult o) => o -> m HitTestResult Source #

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

Methods

contextIsEditable

hitTestResultContextIsEditable Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Bool

Returns: True if there's an editable element at the coordinates of the hitTestResult, or False otherwise

Gets whether HitTestResultContextEditable flag is present in HitTestResult:context.

contextIsImage

hitTestResultContextIsImage Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Bool

Returns: True if there's an image element in the coordinates of the Hit Test, or False otherwise

Gets whether HitTestResultContextImage flag is present in HitTestResult:context.

contextIsLink

hitTestResultContextIsLink Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Bool

Returns: True if there's a link element in the coordinates of the Hit Test, or False otherwise

Gets whether HitTestResultContextLink flag is present in HitTestResult:context.

contextIsMedia

hitTestResultContextIsMedia Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Bool

Returns: True if there's a media element in the coordinates of the Hit Test, or False otherwise

Gets whether HitTestResultContextMedia flag is present in HitTestResult:context.

contextIsScrollbar

hitTestResultContextIsScrollbar Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Bool

Returns: True if there's a scrollbar element at the coordinates of the hitTestResult, or False otherwise

Gets whether HitTestResultContextScrollbar flag is present in HitTestResult:context.

contextIsSelection

hitTestResultContextIsSelection Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Bool

Returns: True if there's a selected element at the coordinates of the hitTestResult, or False otherwise

Gets whether HitTestResultContextSelection flag is present in HitTestResult:context.

Since: 2.8

getContext

hitTestResultGetContext Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Word32

Returns: a bitmask of HitTestResultContext flags

Gets the value of the HitTestResult:context property.

getImageUri

hitTestResultGetImageUri Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Text

Returns: the URI of the image element in the coordinates of the Hit Test, or Nothing if there isn't an image element in hitTestResult context

Gets the value of the HitTestResult:imageUri property.

getLinkLabel

hitTestResultGetLinkLabel Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Text

Returns: the label of the link element in the coordinates of the Hit Test, or Nothing if there isn't a link element in hitTestResult context or the link element doesn't have a label

Gets the value of the HitTestResult:linkLabel property.

getLinkTitle

hitTestResultGetLinkTitle Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Text

Returns: the title of the link element in the coordinates of the Hit Test, or Nothing if there isn't a link element in hitTestResult context or the link element doesn't have a title

Gets the value of the HitTestResult:linkTitle property.

getLinkUri

hitTestResultGetLinkUri Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Text

Returns: the URI of the link element in the coordinates of the Hit Test, or Nothing if there isn't a link element in hitTestResult context

Gets the value of the HitTestResult:linkUri property.

getMediaUri

hitTestResultGetMediaUri Source #

Arguments

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

hitTestResult: a HitTestResult

-> m Text

Returns: the URI of the media element in the coordinates of the Hit Test, or Nothing if there isn't a media element in hitTestResult context

Gets the value of the HitTestResult:mediaUri property.

Properties

context

Bitmask of HitTestResultContext flags representing the context of the HitTestResult.

constructHitTestResultContext :: (IsHitTestResult o, MonadIO m) => Word32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “context” property. This is rarely needed directly, but it is used by new.

getHitTestResultContext :: (MonadIO m, IsHitTestResult o) => o -> m Word32 Source #

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

get hitTestResult #context

imageUri

The URI of the image if flag HitTestResultContextImage is present in HitTestResult:context

constructHitTestResultImageUri :: (IsHitTestResult o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “image-uri” property. This is rarely needed directly, but it is used by new.

getHitTestResultImageUri :: (MonadIO m, IsHitTestResult o) => o -> m Text Source #

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

get hitTestResult #imageUri

linkLabel

The label of the link if flag HitTestResultContextLink is present in HitTestResult:context

constructHitTestResultLinkLabel :: (IsHitTestResult o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “link-label” property. This is rarely needed directly, but it is used by new.

getHitTestResultLinkLabel :: (MonadIO m, IsHitTestResult o) => o -> m Text Source #

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

get hitTestResult #linkLabel

linkTitle

The title of the link if flag HitTestResultContextLink is present in HitTestResult:context

constructHitTestResultLinkTitle :: (IsHitTestResult o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “link-title” property. This is rarely needed directly, but it is used by new.

getHitTestResultLinkTitle :: (MonadIO m, IsHitTestResult o) => o -> m Text Source #

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

get hitTestResult #linkTitle

linkUri

The URI of the link if flag HitTestResultContextLink is present in HitTestResult:context

constructHitTestResultLinkUri :: (IsHitTestResult o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “link-uri” property. This is rarely needed directly, but it is used by new.

getHitTestResultLinkUri :: (MonadIO m, IsHitTestResult o) => o -> m Text Source #

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

get hitTestResult #linkUri

mediaUri

The URI of the media if flag HitTestResultContextMedia is present in HitTestResult:context

constructHitTestResultMediaUri :: (IsHitTestResult o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “media-uri” property. This is rarely needed directly, but it is used by new.

getHitTestResultMediaUri :: (MonadIO m, IsHitTestResult o) => o -> m Text Source #

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

get hitTestResult #mediaUri