gi-webkit2-4.0.11: WebKit2 bindings

CopyrightWill Thompson, Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (garetxe@gmail.com)
Safe HaskellNone
LanguageHaskell2010

GI.WebKit2.Objects.FindController

Contents

Description

 

Synopsis

Exported types

Methods

countMatches

findControllerCountMatches Source #

Arguments

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

findController: the FindController

-> Text

searchText: the text to look for

-> Word32

findOptions: a bitmask with the FindOptions used in the search

-> Word32

maxMatchCount: the maximum number of matches allowed in the search

-> m () 

Counts the number of matches for searchText found in the WebView with the provided findOptions. The number of matches will be provided by the FindController::counted-matches signal.

getMaxMatchCount

findControllerGetMaxMatchCount Source #

Arguments

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

findController: the FindController

-> m Word32

Returns: the maximum number of matches to report.

Gets the maximum number of matches to report during a text lookup. This number is passed as the last argument of findControllerSearch or findControllerCountMatches.

getOptions

findControllerGetOptions Source #

Arguments

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

findController: the FindController

-> m Word32

Returns: a bitmask containing the FindOptions associated with the current search.

Gets a bitmask containing the FindOptions associated with the current search.

getSearchText

findControllerGetSearchText Source #

Arguments

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

findController: the FindController

-> m Text

Returns: the text to look for in the WebView.

Gets the text that findController is currently searching for. This text is passed to either findControllerSearch or findControllerCountMatches.

getWebView

findControllerGetWebView Source #

Arguments

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

findController: the FindController

-> m WebView

Returns: the WebView.

Gets the WebView this find controller is associated to. Do not unref the returned instance as it belongs to the FindController.

search

findControllerSearch Source #

Arguments

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

findController: the FindController

-> Text

searchText: the text to look for

-> Word32

findOptions: a bitmask with the FindOptions used in the search

-> Word32

maxMatchCount: the maximum number of matches allowed in the search

-> m () 

Looks for searchText in the WebView associated with findController since the beginning of the document highlighting up to maxMatchCount matches. The outcome of the search will be asynchronously provided by the FindController::found-text and FindController::failed-to-find-text signals.

To look for the next or previous occurrences of the same text with the same find options use findControllerSearchNext and/or findControllerSearchPrevious. The FindController will use the same text and options for the following searches unless they are modified by another call to this method.

Note that if the number of matches is higher than maxMatchCount then FindController::found-text will report G_MAXUINT matches instead of the actual number.

Callers should call findControllerSearchFinish to finish the current search operation.

searchFinish

findControllerSearchFinish Source #

Arguments

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

findController: a FindController

-> m () 

Finishes a find operation started by findControllerSearch. It will basically unhighlight every text match found.

This method will be typically called when the search UI is closed/hidden by the client application.

searchNext

findControllerSearchNext Source #

Arguments

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

findController: the FindController

-> m () 

Looks for the next occurrence of the search text.

Calling this method before findControllerSearch or findControllerCountMatches is a programming error.

searchPrevious

findControllerSearchPrevious Source #

Arguments

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

findController: the FindController

-> m () 

Looks for the previous occurrence of the search text.

Calling this method before findControllerSearch or findControllerCountMatches is a programming error.

Properties

maxMatchCount

data FindControllerMaxMatchCountPropertyInfo Source #

Instances

AttrInfo FindControllerMaxMatchCountPropertyInfo Source # 
type AttrOrigin FindControllerMaxMatchCountPropertyInfo Source # 
type AttrLabel FindControllerMaxMatchCountPropertyInfo Source # 
type AttrGetType FindControllerMaxMatchCountPropertyInfo Source # 
type AttrBaseTypeConstraint FindControllerMaxMatchCountPropertyInfo Source # 
type AttrSetTypeConstraint FindControllerMaxMatchCountPropertyInfo Source # 
type AttrAllowedOps FindControllerMaxMatchCountPropertyInfo Source # 

options

data FindControllerOptionsPropertyInfo Source #

Instances

AttrInfo FindControllerOptionsPropertyInfo Source # 
type AttrOrigin FindControllerOptionsPropertyInfo Source # 
type AttrLabel FindControllerOptionsPropertyInfo Source # 
type AttrGetType FindControllerOptionsPropertyInfo Source # 
type AttrBaseTypeConstraint FindControllerOptionsPropertyInfo Source # 
type AttrSetTypeConstraint FindControllerOptionsPropertyInfo Source # 
type AttrAllowedOps FindControllerOptionsPropertyInfo Source # 

text

data FindControllerTextPropertyInfo Source #

Instances

AttrInfo FindControllerTextPropertyInfo Source # 
type AttrOrigin FindControllerTextPropertyInfo Source # 
type AttrLabel FindControllerTextPropertyInfo Source # 
type AttrGetType FindControllerTextPropertyInfo Source # 
type AttrBaseTypeConstraint FindControllerTextPropertyInfo Source # 
type AttrSetTypeConstraint FindControllerTextPropertyInfo Source # 
type AttrAllowedOps FindControllerTextPropertyInfo Source # 

webView

data FindControllerWebViewPropertyInfo Source #

Instances

AttrInfo FindControllerWebViewPropertyInfo Source # 
type AttrOrigin FindControllerWebViewPropertyInfo Source # 
type AttrLabel FindControllerWebViewPropertyInfo Source # 
type AttrGetType FindControllerWebViewPropertyInfo Source # 
type AttrBaseTypeConstraint FindControllerWebViewPropertyInfo Source # 
type AttrSetTypeConstraint FindControllerWebViewPropertyInfo Source # 
type AttrAllowedOps FindControllerWebViewPropertyInfo Source # 

Signals

countedMatches

failedToFindText

foundText