gi-gtk-3.0.28: GI/Gtk/Structs/TreePath.hs
{- |
Copyright : Will Thompson, Iñaki García Etxebarria and Jonas Platte
License : LGPL-2.1
Maintainer : Iñaki García Etxebarria (inaki@blueleaf.cc)
/No description available in the introspection data./
-}
#define ENABLE_OVERLOADING (MIN_VERSION_haskell_gi_overloading(1,0,0) \
&& !defined(__HADDOCK_VERSION__))
module GI.Gtk.Structs.TreePath
(
-- * Exported types
TreePath(..) ,
noTreePath ,
-- * Methods
-- ** appendIndex #method:appendIndex#
#if ENABLE_OVERLOADING
TreePathAppendIndexMethodInfo ,
#endif
treePathAppendIndex ,
-- ** compare #method:compare#
#if ENABLE_OVERLOADING
TreePathCompareMethodInfo ,
#endif
treePathCompare ,
-- ** copy #method:copy#
#if ENABLE_OVERLOADING
TreePathCopyMethodInfo ,
#endif
treePathCopy ,
-- ** down #method:down#
#if ENABLE_OVERLOADING
TreePathDownMethodInfo ,
#endif
treePathDown ,
-- ** free #method:free#
#if ENABLE_OVERLOADING
TreePathFreeMethodInfo ,
#endif
treePathFree ,
-- ** getDepth #method:getDepth#
#if ENABLE_OVERLOADING
TreePathGetDepthMethodInfo ,
#endif
treePathGetDepth ,
-- ** getIndices #method:getIndices#
#if ENABLE_OVERLOADING
TreePathGetIndicesMethodInfo ,
#endif
treePathGetIndices ,
-- ** isAncestor #method:isAncestor#
#if ENABLE_OVERLOADING
TreePathIsAncestorMethodInfo ,
#endif
treePathIsAncestor ,
-- ** isDescendant #method:isDescendant#
#if ENABLE_OVERLOADING
TreePathIsDescendantMethodInfo ,
#endif
treePathIsDescendant ,
-- ** new #method:new#
treePathNew ,
-- ** newFirst #method:newFirst#
treePathNewFirst ,
-- ** newFromIndices #method:newFromIndices#
treePathNewFromIndices ,
-- ** newFromString #method:newFromString#
treePathNewFromString ,
-- ** next #method:next#
#if ENABLE_OVERLOADING
TreePathNextMethodInfo ,
#endif
treePathNext ,
-- ** prependIndex #method:prependIndex#
#if ENABLE_OVERLOADING
TreePathPrependIndexMethodInfo ,
#endif
treePathPrependIndex ,
-- ** prev #method:prev#
#if ENABLE_OVERLOADING
TreePathPrevMethodInfo ,
#endif
treePathPrev ,
-- ** toString #method:toString#
#if ENABLE_OVERLOADING
TreePathToStringMethodInfo ,
#endif
treePathToString ,
-- ** up #method:up#
#if ENABLE_OVERLOADING
TreePathUpMethodInfo ,
#endif
treePathUp ,
) where
import Data.GI.Base.ShortPrelude
import qualified Data.GI.Base.ShortPrelude as SP
import qualified Data.GI.Base.Overloading as O
import qualified Prelude as P
import qualified Data.GI.Base.Attributes as GI.Attributes
import qualified Data.GI.Base.ManagedPtr as B.ManagedPtr
import qualified Data.GI.Base.GClosure as B.GClosure
import qualified Data.GI.Base.GError as B.GError
import qualified Data.GI.Base.GVariant as B.GVariant
import qualified Data.GI.Base.GValue as B.GValue
import qualified Data.GI.Base.GParamSpec as B.GParamSpec
import qualified Data.GI.Base.CallStack as B.CallStack
import qualified Data.GI.Base.Properties as B.Properties
import qualified Data.Text as T
import qualified Data.ByteString.Char8 as B
import qualified Data.Map as Map
import qualified Foreign.Ptr as FP
import qualified GHC.OverloadedLabels as OL
-- | Memory-managed wrapper type.
newtype TreePath = TreePath (ManagedPtr TreePath)
foreign import ccall "gtk_tree_path_get_type" c_gtk_tree_path_get_type ::
IO GType
instance BoxedObject TreePath where
boxedType _ = c_gtk_tree_path_get_type
-- | A convenience alias for `Nothing` :: `Maybe` `TreePath`.
noTreePath :: Maybe TreePath
noTreePath = Nothing
#if ENABLE_OVERLOADING
instance O.HasAttributeList TreePath
type instance O.AttributeList TreePath = TreePathAttributeList
type TreePathAttributeList = ('[ ] :: [(Symbol, *)])
#endif
-- method TreePath::new
-- method type : Constructor
-- Args : []
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gtk", name = "TreePath"}))
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_new" gtk_tree_path_new ::
IO (Ptr TreePath)
{- |
Creates a new 'GI.Gtk.Structs.TreePath.TreePath'-struct.
This refers to a row.
-}
treePathNew ::
(B.CallStack.HasCallStack, MonadIO m) =>
m TreePath
{- ^ __Returns:__ A newly created 'GI.Gtk.Structs.TreePath.TreePath'-struct. -}
treePathNew = liftIO $ do
result <- gtk_tree_path_new
checkUnexpectedReturnNULL "treePathNew" result
result' <- (wrapBoxed TreePath) result
return result'
#if ENABLE_OVERLOADING
#endif
-- method TreePath::new_first
-- method type : Constructor
-- Args : []
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gtk", name = "TreePath"}))
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_new_first" gtk_tree_path_new_first ::
IO (Ptr TreePath)
{- |
Creates a new 'GI.Gtk.Structs.TreePath.TreePath'-struct.
The string representation of this path is “0”.
-}
treePathNewFirst ::
(B.CallStack.HasCallStack, MonadIO m) =>
m TreePath
{- ^ __Returns:__ A new 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
treePathNewFirst = liftIO $ do
result <- gtk_tree_path_new_first
checkUnexpectedReturnNULL "treePathNewFirst" result
result' <- (wrapBoxed TreePath) result
return result'
#if ENABLE_OVERLOADING
#endif
-- method TreePath::new_from_indices
-- method type : Constructor
-- Args : [Arg {argCName = "indices", argType = TCArray False (-1) 1 (TBasicType TInt), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "array of indices", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "length", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "length of @indices array", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : [Arg {argCName = "length", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "length of @indices array", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- returnType : Just (TInterface (Name {namespace = "Gtk", name = "TreePath"}))
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_new_from_indicesv" gtk_tree_path_new_from_indicesv ::
Ptr Int32 -> -- indices : TCArray False (-1) 1 (TBasicType TInt)
Word64 -> -- length : TBasicType TUInt64
IO (Ptr TreePath)
{- |
Creates a new path with the given /@indices@/ array of /@length@/.
/Since: 3.12/
-}
treePathNewFromIndices ::
(B.CallStack.HasCallStack, MonadIO m) =>
[Int32]
{- ^ /@indices@/: array of indices -}
-> m TreePath
{- ^ __Returns:__ A newly created 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
treePathNewFromIndices indices = liftIO $ do
let length_ = fromIntegral $ length indices
indices' <- packStorableArray indices
result <- gtk_tree_path_new_from_indicesv indices' length_
checkUnexpectedReturnNULL "treePathNewFromIndices" result
result' <- (wrapBoxed TreePath) result
freeMem indices'
return result'
#if ENABLE_OVERLOADING
#endif
-- method TreePath::new_from_string
-- method type : Constructor
-- Args : [Arg {argCName = "path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The string representation of a path", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gtk", name = "TreePath"}))
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_new_from_string" gtk_tree_path_new_from_string ::
CString -> -- path : TBasicType TUTF8
IO (Ptr TreePath)
{- |
Creates a new 'GI.Gtk.Structs.TreePath.TreePath'-struct 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.
-}
treePathNewFromString ::
(B.CallStack.HasCallStack, MonadIO m) =>
T.Text
{- ^ /@path@/: The string representation of a path -}
-> m TreePath
{- ^ __Returns:__ A newly-created 'GI.Gtk.Structs.TreePath.TreePath'-struct, or 'Nothing' -}
treePathNewFromString path = liftIO $ do
path' <- textToCString path
result <- gtk_tree_path_new_from_string path'
checkUnexpectedReturnNULL "treePathNewFromString" result
result' <- (wrapBoxed TreePath) result
freeMem path'
return result'
#if ENABLE_OVERLOADING
#endif
-- method TreePath::append_index
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "index_", argType = TBasicType TInt, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the index", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_append_index" gtk_tree_path_append_index ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
Int32 -> -- index_ : TBasicType TInt
IO ()
{- |
Appends a new index to a path.
As a result, the depth of the path is increased.
-}
treePathAppendIndex ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> Int32
{- ^ /@index_@/: the index -}
-> m ()
treePathAppendIndex path index_ = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
gtk_tree_path_append_index path' index_
touchManagedPtr path
return ()
#if ENABLE_OVERLOADING
data TreePathAppendIndexMethodInfo
instance (signature ~ (Int32 -> m ()), MonadIO m) => O.MethodInfo TreePathAppendIndexMethodInfo TreePath signature where
overloadedMethod _ = treePathAppendIndex
#endif
-- method TreePath::compare
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "a", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "b", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct to compare with", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TInt)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_compare" gtk_tree_path_compare ::
Ptr TreePath -> -- a : TInterface (Name {namespace = "Gtk", name = "TreePath"})
Ptr TreePath -> -- b : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO Int32
{- |
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.
-}
treePathCompare ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@a@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> TreePath
{- ^ /@b@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct to compare with -}
-> m Int32
{- ^ __Returns:__ the relative positions of /@a@/ and /@b@/ -}
treePathCompare a b = liftIO $ do
a' <- unsafeManagedPtrGetPtr a
b' <- unsafeManagedPtrGetPtr b
result <- gtk_tree_path_compare a' b'
touchManagedPtr a
touchManagedPtr b
return result
#if ENABLE_OVERLOADING
data TreePathCompareMethodInfo
instance (signature ~ (TreePath -> m Int32), MonadIO m) => O.MethodInfo TreePathCompareMethodInfo TreePath signature where
overloadedMethod _ = treePathCompare
#endif
-- method TreePath::copy
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gtk", name = "TreePath"}))
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_copy" gtk_tree_path_copy ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO (Ptr TreePath)
{- |
Creates a new 'GI.Gtk.Structs.TreePath.TreePath'-struct as a copy of /@path@/.
-}
treePathCopy ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m TreePath
{- ^ __Returns:__ a new 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
treePathCopy path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
result <- gtk_tree_path_copy path'
checkUnexpectedReturnNULL "treePathCopy" result
result' <- (wrapBoxed TreePath) result
touchManagedPtr path
return result'
#if ENABLE_OVERLOADING
data TreePathCopyMethodInfo
instance (signature ~ (m TreePath), MonadIO m) => O.MethodInfo TreePathCopyMethodInfo TreePath signature where
overloadedMethod _ = treePathCopy
#endif
-- method TreePath::down
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_down" gtk_tree_path_down ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO ()
{- |
Moves /@path@/ to point to the first child of the current path.
-}
treePathDown ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m ()
treePathDown path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
gtk_tree_path_down path'
touchManagedPtr path
return ()
#if ENABLE_OVERLOADING
data TreePathDownMethodInfo
instance (signature ~ (m ()), MonadIO m) => O.MethodInfo TreePathDownMethodInfo TreePath signature where
overloadedMethod _ = treePathDown
#endif
-- method TreePath::free
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_free" gtk_tree_path_free ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO ()
{- |
Frees /@path@/. If /@path@/ is 'Nothing', it simply returns.
-}
treePathFree ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m ()
treePathFree path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
gtk_tree_path_free path'
touchManagedPtr path
return ()
#if ENABLE_OVERLOADING
data TreePathFreeMethodInfo
instance (signature ~ (m ()), MonadIO m) => O.MethodInfo TreePathFreeMethodInfo TreePath signature where
overloadedMethod _ = treePathFree
#endif
-- method TreePath::get_depth
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TInt)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_get_depth" gtk_tree_path_get_depth ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO Int32
{- |
Returns the current depth of /@path@/.
-}
treePathGetDepth ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m Int32
{- ^ __Returns:__ The depth of /@path@/ -}
treePathGetDepth path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
result <- gtk_tree_path_get_depth path'
touchManagedPtr path
return result
#if ENABLE_OVERLOADING
data TreePathGetDepthMethodInfo
instance (signature ~ (m Int32), MonadIO m) => O.MethodInfo TreePathGetDepthMethodInfo TreePath signature where
overloadedMethod _ = treePathGetDepth
#endif
-- method TreePath::get_indices
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "depth", argType = TBasicType TInt, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "return location for number of elements\n returned in the integer array, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : [Arg {argCName = "depth", argType = TBasicType TInt, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "return location for number of elements\n returned in the integer array, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- returnType : Just (TCArray False (-1) 1 (TBasicType TInt))
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_get_indices_with_depth" gtk_tree_path_get_indices_with_depth ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
Ptr Int32 -> -- depth : TBasicType TInt
IO (Ptr Int32)
{- |
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.
/Since: 3.0/
-}
treePathGetIndices ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m (Maybe [Int32])
{- ^ __Returns:__ The current
indices, or 'Nothing' -}
treePathGetIndices path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
depth <- allocMem :: IO (Ptr Int32)
result <- gtk_tree_path_get_indices_with_depth path' depth
depth' <- peek depth
maybeResult <- convertIfNonNull result $ \result' -> do
result'' <- (unpackStorableArrayWithLength depth') result'
return result''
touchManagedPtr path
freeMem depth
return maybeResult
#if ENABLE_OVERLOADING
data TreePathGetIndicesMethodInfo
instance (signature ~ (m (Maybe [Int32])), MonadIO m) => O.MethodInfo TreePathGetIndicesMethodInfo TreePath signature where
overloadedMethod _ = treePathGetIndices
#endif
-- method TreePath::is_ancestor
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "descendant", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "another #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_is_ancestor" gtk_tree_path_is_ancestor ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
Ptr TreePath -> -- descendant : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO CInt
{- |
Returns 'True' if /@descendant@/ is a descendant of /@path@/.
-}
treePathIsAncestor ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> TreePath
{- ^ /@descendant@/: another 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m Bool
{- ^ __Returns:__ 'True' if /@descendant@/ is contained inside /@path@/ -}
treePathIsAncestor path descendant = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
descendant' <- unsafeManagedPtrGetPtr descendant
result <- gtk_tree_path_is_ancestor path' descendant'
let result' = (/= 0) result
touchManagedPtr path
touchManagedPtr descendant
return result'
#if ENABLE_OVERLOADING
data TreePathIsAncestorMethodInfo
instance (signature ~ (TreePath -> m Bool), MonadIO m) => O.MethodInfo TreePathIsAncestorMethodInfo TreePath signature where
overloadedMethod _ = treePathIsAncestor
#endif
-- method TreePath::is_descendant
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "ancestor", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "another #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_is_descendant" gtk_tree_path_is_descendant ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
Ptr TreePath -> -- ancestor : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO CInt
{- |
Returns 'True' if /@path@/ is a descendant of /@ancestor@/.
-}
treePathIsDescendant ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> TreePath
{- ^ /@ancestor@/: another 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m Bool
{- ^ __Returns:__ 'True' if /@ancestor@/ contains /@path@/ somewhere below it -}
treePathIsDescendant path ancestor = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
ancestor' <- unsafeManagedPtrGetPtr ancestor
result <- gtk_tree_path_is_descendant path' ancestor'
let result' = (/= 0) result
touchManagedPtr path
touchManagedPtr ancestor
return result'
#if ENABLE_OVERLOADING
data TreePathIsDescendantMethodInfo
instance (signature ~ (TreePath -> m Bool), MonadIO m) => O.MethodInfo TreePathIsDescendantMethodInfo TreePath signature where
overloadedMethod _ = treePathIsDescendant
#endif
-- method TreePath::next
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_next" gtk_tree_path_next ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO ()
{- |
Moves the /@path@/ to point to the next node at the current depth.
-}
treePathNext ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m ()
treePathNext path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
gtk_tree_path_next path'
touchManagedPtr path
return ()
#if ENABLE_OVERLOADING
data TreePathNextMethodInfo
instance (signature ~ (m ()), MonadIO m) => O.MethodInfo TreePathNextMethodInfo TreePath signature where
overloadedMethod _ = treePathNext
#endif
-- method TreePath::prepend_index
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "index_", argType = TBasicType TInt, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the index", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_prepend_index" gtk_tree_path_prepend_index ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
Int32 -> -- index_ : TBasicType TInt
IO ()
{- |
Prepends a new index to a path.
As a result, the depth of the path is increased.
-}
treePathPrependIndex ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> Int32
{- ^ /@index_@/: the index -}
-> m ()
treePathPrependIndex path index_ = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
gtk_tree_path_prepend_index path' index_
touchManagedPtr path
return ()
#if ENABLE_OVERLOADING
data TreePathPrependIndexMethodInfo
instance (signature ~ (Int32 -> m ()), MonadIO m) => O.MethodInfo TreePathPrependIndexMethodInfo TreePath signature where
overloadedMethod _ = treePathPrependIndex
#endif
-- method TreePath::prev
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_prev" gtk_tree_path_prev ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO CInt
{- |
Moves the /@path@/ to point to the previous node at the
current depth, if it exists.
-}
treePathPrev ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m Bool
{- ^ __Returns:__ 'True' if /@path@/ has a previous node, and
the move was made -}
treePathPrev path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
result <- gtk_tree_path_prev path'
let result' = (/= 0) result
touchManagedPtr path
return result'
#if ENABLE_OVERLOADING
data TreePathPrevMethodInfo
instance (signature ~ (m Bool), MonadIO m) => O.MethodInfo TreePathPrevMethodInfo TreePath signature where
overloadedMethod _ = treePathPrev
#endif
-- method TreePath::to_string
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_to_string" gtk_tree_path_to_string ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO CString
{- |
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.
-}
treePathToString ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: A 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m T.Text
{- ^ __Returns:__ A newly-allocated string.
Must be freed with 'GI.GLib.Functions.free'. -}
treePathToString path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
result <- gtk_tree_path_to_string path'
checkUnexpectedReturnNULL "treePathToString" result
result' <- cstringToText result
freeMem result
touchManagedPtr path
return result'
#if ENABLE_OVERLOADING
data TreePathToStringMethodInfo
instance (signature ~ (m T.Text), MonadIO m) => O.MethodInfo TreePathToStringMethodInfo TreePath signature where
overloadedMethod _ = treePathToString
#endif
-- method TreePath::up
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "path", argType = TInterface (Name {namespace = "Gtk", name = "TreePath"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GtkTreePath-struct", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "gtk_tree_path_up" gtk_tree_path_up ::
Ptr TreePath -> -- path : TInterface (Name {namespace = "Gtk", name = "TreePath"})
IO CInt
{- |
Moves the /@path@/ to point to its parent node, if it has a parent.
-}
treePathUp ::
(B.CallStack.HasCallStack, MonadIO m) =>
TreePath
{- ^ /@path@/: a 'GI.Gtk.Structs.TreePath.TreePath'-struct -}
-> m Bool
{- ^ __Returns:__ 'True' if /@path@/ has a parent, and the move was made -}
treePathUp path = liftIO $ do
path' <- unsafeManagedPtrGetPtr path
result <- gtk_tree_path_up path'
let result' = (/= 0) result
touchManagedPtr path
return result'
#if ENABLE_OVERLOADING
data TreePathUpMethodInfo
instance (signature ~ (m Bool), MonadIO m) => O.MethodInfo TreePathUpMethodInfo TreePath signature where
overloadedMethod _ = treePathUp
#endif
#if ENABLE_OVERLOADING
type family ResolveTreePathMethod (t :: Symbol) (o :: *) :: * where
ResolveTreePathMethod "appendIndex" o = TreePathAppendIndexMethodInfo
ResolveTreePathMethod "compare" o = TreePathCompareMethodInfo
ResolveTreePathMethod "copy" o = TreePathCopyMethodInfo
ResolveTreePathMethod "down" o = TreePathDownMethodInfo
ResolveTreePathMethod "free" o = TreePathFreeMethodInfo
ResolveTreePathMethod "isAncestor" o = TreePathIsAncestorMethodInfo
ResolveTreePathMethod "isDescendant" o = TreePathIsDescendantMethodInfo
ResolveTreePathMethod "next" o = TreePathNextMethodInfo
ResolveTreePathMethod "prependIndex" o = TreePathPrependIndexMethodInfo
ResolveTreePathMethod "prev" o = TreePathPrevMethodInfo
ResolveTreePathMethod "toString" o = TreePathToStringMethodInfo
ResolveTreePathMethod "up" o = TreePathUpMethodInfo
ResolveTreePathMethod "getDepth" o = TreePathGetDepthMethodInfo
ResolveTreePathMethod "getIndices" o = TreePathGetIndicesMethodInfo
ResolveTreePathMethod l o = O.MethodResolutionFailed l o
instance (info ~ ResolveTreePathMethod t TreePath, O.MethodInfo info TreePath p) => OL.IsLabel t (TreePath -> p) where
#if MIN_VERSION_base(4,10,0)
fromLabel = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)
#else
fromLabel _ = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)
#endif
#endif