gi-atk-2.0.20: Atk bindings

CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (inaki@blueleaf.cc)
Safe HaskellNone
LanguageHaskell2010

GI.Atk.Interfaces.Selection

Contents

Description

Selection should be implemented by UI components with children which are exposed by atk_object_ref_child and atk_object_get_n_children, if the use of the parent UI component ordinarily involves selection of one or more of the objects corresponding to those Object children - for example, selectable lists.

Note that other types of "selection" (for instance text selection) are accomplished a other ATK interfaces - Selection is limited to the selection/deselection of children.

Synopsis

Exported types

newtype Selection Source #

Memory-managed wrapper type.

Instances
GObject Selection Source # 
Instance details

Defined in GI.Atk.Interfaces.Selection

Methods

gobjectType :: IO GType #

HasParentTypes Selection Source # 
Instance details

Defined in GI.Atk.Interfaces.Selection

type ParentTypes Selection Source # 
Instance details

Defined in GI.Atk.Interfaces.Selection

type ParentTypes Selection = Object ': ([] :: [Type])

noSelection :: Maybe Selection Source #

A convenience alias for Nothing :: Maybe Selection.

class (GObject o, IsDescendantOf Selection o) => IsSelection o Source #

Type class for types which can be safely cast to Selection, for instance with toSelection.

Instances
(GObject o, IsDescendantOf Selection o) => IsSelection o Source # 
Instance details

Defined in GI.Atk.Interfaces.Selection

toSelection :: (MonadIO m, IsSelection o) => o -> m Selection Source #

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

Methods

addSelection

selectionAddSelection Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> Int32

i: a gint specifying the child index.

-> m Bool

Returns: TRUE if success, FALSE otherwise.

Adds the specified accessible child of the object to the object's selection.

clearSelection

selectionClearSelection Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> m Bool

Returns: TRUE if success, FALSE otherwise.

Clears the selection in the object so that no children in the object are selected.

getSelectionCount

selectionGetSelectionCount Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> m Int32

Returns: a gint representing the number of items selected, or 0 if selection does not implement this interface.

Gets the number of accessible children currently selected. Note: callers should not rely on Nothing or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_value() convenience method.

isChildSelected

selectionIsChildSelected Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> Int32

i: a gint specifying the child index.

-> m Bool

Returns: a gboolean representing the specified child is selected, or 0 if selection does not implement this interface.

Determines if the current child of this object is selected Note: callers should not rely on Nothing or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_value() convenience method.

refSelection

selectionRefSelection Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> Int32

i: a gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child).

-> m (Maybe Object)

Returns: an Object representing the selected accessible, or Nothing if selection does not implement this interface.

Gets a reference to the accessible object representing the specified selected child of the object. Note: callers should not rely on Nothing or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_value() convenience method.

removeSelection

selectionRemoveSelection Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> Int32

i: a gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child).

-> m Bool

Returns: TRUE if success, FALSE otherwise.

Removes the specified child of the object from the object's selection.

selectAllSelection

selectionSelectAllSelection Source #

Arguments

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

selection: a Object instance that implements AtkSelectionIface

-> m Bool

Returns: TRUE if success, FALSE otherwise.

Causes every child of the object to be selected if the object supports multiple selections.

Signals

selectionChanged

type C_SelectionSelectionChangedCallback = Ptr () -> Ptr () -> IO () Source #

Type for the callback on the (unwrapped) C side.

type SelectionSelectionChangedCallback = IO () Source #

The "selection-changed" signal is emitted by an object which implements AtkSelection interface when the selection changes.

afterSelectionSelectionChanged :: (IsSelection a, MonadIO m) => a -> SelectionSelectionChangedCallback -> m SignalHandlerId Source #

Connect a signal handler for the “selection-changed” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after selection #selectionChanged callback

onSelectionSelectionChanged :: (IsSelection a, MonadIO m) => a -> SelectionSelectionChangedCallback -> m SignalHandlerId Source #

Connect a signal handler for the “selection-changed” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on selection #selectionChanged callback