GI.Gtk.Structs.TreePath

An opaque structure representing a path to a row in a model.

Exported types

newtype TreePath

Memory-managed wrapper type.

Constructors

TreePath (ManagedPtr TreePath)

Instances

Eq TreePath

Defined in GI.Gtk.Structs.TreePath

Methods

(==) :: TreePath -> TreePath -> Bool

(/=) :: TreePath -> TreePath -> Bool

GBoxed TreePath

Defined in GI.Gtk.Structs.TreePath

ManagedPtrNewtype TreePath

Defined in GI.Gtk.Structs.TreePath

Methods

toManagedPtr :: TreePath -> ManagedPtr TreePath

TypedObject TreePath

Defined in GI.Gtk.Structs.TreePath

Methods

glibType :: IO GType

HasParentTypes TreePath

Defined in GI.Gtk.Structs.TreePath

IsGValue (Maybe TreePath)

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

Defined in GI.Gtk.Structs.TreePath

Methods

gvalueGType_ :: IO GType

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

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

type ParentTypes TreePath

Defined in GI.Gtk.Structs.TreePath

type ParentTypes TreePath = '[] :: [Type]

Methods

Click to display all available methods, including inherited ones

Methods

appendIndex, compare, copy, down, free, isAncestor, isDescendant, next, prependIndex, prev, toString, up.

Getters

getDepth, getIndices.

Setters

None.

appendIndex

treePathAppendIndex

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> Int32

index_: the index

-> m ()

Deprecated: (Since version 4.10)

Appends a new index to a path.

As a result, the depth of the path is increased.

compare

treePathCompare

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

a: a GtkTreePath

-> TreePath

b: a GtkTreePath to compare with

-> m Int32

Returns: the relative positions of a and b

Deprecated: (Since version 4.10)

Compares two paths.

If a appears before b in a tree, then -1 is returned. If b appears before a, then 1 is returned. If the two nodes are equal, then 0 is returned.

copy

treePathCopy

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m TreePath

Returns: a new GtkTreePath

Deprecated: (Since version 4.10)

Creates a new GtkTreePath as a copy of path.

down

treePathDown

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m ()

Deprecated: (Since version 4.10)

Moves path to point to the first child of the current path.

free

treePathFree

Arguments

:: (HasCallStack, MonadIO m)

=> Maybe TreePath

path: a GtkTreePath

-> m ()

Deprecated: (Since version 4.10)

Frees path. If path is Nothing, it simply returns.

getDepth

treePathGetDepth

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m Int32

Returns: The depth of path

Deprecated: (Since version 4.10)

Returns the current depth of path.

getIndices

treePathGetIndices

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m (Maybe [Int32])

Returns: The current indices

Deprecated: (Since version 4.10)

Returns the current indices of path.

This is an array of integers, each representing a node in a tree. It also returns the number of elements in the array. The array should not be freed.

isAncestor

treePathIsAncestor

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> TreePath

descendant: another GtkTreePath

-> m Bool

Returns: True if descendant is contained inside path

Deprecated: (Since version 4.10)

Returns True if descendant is a descendant of path.

isDescendant

treePathIsDescendant

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> TreePath

ancestor: another GtkTreePath

-> m Bool

Returns: True if ancestor contains path somewhere below it

Deprecated: (Since version 4.10)

Returns True if path is a descendant of ancestor.

new

treePathNew

Arguments

:: (HasCallStack, MonadIO m)

=> m TreePath

Returns: A newly created GtkTreePath.

Deprecated: (Since version 4.10)

Creates a new GtkTreePath This refers to a row.

newFirst

treePathNewFirst

Arguments

:: (HasCallStack, MonadIO m)

=> m TreePath

Returns: A new GtkTreePath

Deprecated: (Since version 4.10)

Creates a new GtkTreePath.

The string representation of this path is “0”.

newFromIndices

treePathNewFromIndices

Arguments

:: (HasCallStack, MonadIO m)

=> [Int32]

indices: array of indices

-> m TreePath

Returns: A newly created GtkTreePath

Deprecated: (Since version 4.10)

Creates a new path with the given indices array of length.

newFromString

treePathNewFromString

Arguments

:: (HasCallStack, MonadIO m)

=> Text

path: The string representation of a path

-> m (Maybe TreePath)

Returns: A newly-created GtkTreePath

Deprecated: (Since version 4.10)

Creates a new GtkTreePath initialized to path.

path is expected to be a colon separated list of numbers. For example, the string “10:4:0” would create a path of depth 3 pointing to the 11th child of the root node, the 5th child of that 11th child, and the 1st child of that 5th child. If an invalid path string is passed in, Nothing is returned.

next

treePathNext

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m ()

Deprecated: (Since version 4.10)

Moves the path to point to the next node at the current depth.

prependIndex

treePathPrependIndex

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> Int32

index_: the index

-> m ()

Deprecated: (Since version 4.10)

Prepends a new index to a path.

As a result, the depth of the path is increased.

prev

treePathPrev

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m Bool

Returns: True if path has a previous node, and the move was made

Deprecated: (Since version 4.10)

Moves the path to point to the previous node at the current depth, if it exists.

toString

treePathToString

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m (Maybe Text)

Returns: A newly-allocated string

Deprecated: (Since version 4.10)

Generates a string representation of the path.

This string is a “:” separated list of numbers. For example, “4:10:0:3” would be an acceptable return value for this string. If the path has depth 0, Nothing is returned.

up

treePathUp

Arguments

:: (HasCallStack, MonadIO m)

=> TreePath

path: a GtkTreePath

-> m Bool

Returns: True if path has a parent, and the move was made

Deprecated: (Since version 4.10)

Moves the path to point to its parent node, if it has a parent.