<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>dist/build/Graphics/UI/Gtk/ModelView/TreeDrag.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>-- GENERATED by C->Haskell Compiler, version 0.13.4 (gtk2hs branch) "Bin IO", 13 Nov 2004 (Haskell)</span> <a name="line-2"></a><span class='hs-comment'>-- Edit the ORIGNAL .chs file instead!</span> <a name="line-3"></a> <a name="line-4"></a> <a name="line-5"></a><span class='hs-comment'>{-# LINE 1 "./Graphics/UI/Gtk/ModelView/TreeDrag.chs" #-}</span> <a name="line-6"></a><span class='hs-comment'>-- -*-haskell-*-</span> <a name="line-7"></a><span class='hs-comment'>-- GIMP Toolkit (GTK) Interface DragSource and DragDest</span> <a name="line-8"></a><span class='hs-comment'>--</span> <a name="line-9"></a><span class='hs-comment'>-- Author : Axel Simon</span> <a name="line-10"></a><span class='hs-comment'>--</span> <a name="line-11"></a><span class='hs-comment'>-- Created: 24 July 2007</span> <a name="line-12"></a><span class='hs-comment'>--</span> <a name="line-13"></a><span class='hs-comment'>-- Copyright (C) 2007 Axel Simon</span> <a name="line-14"></a><span class='hs-comment'>--</span> <a name="line-15"></a><span class='hs-comment'>-- This library is free software; you can redistribute it and/or</span> <a name="line-16"></a><span class='hs-comment'>-- modify it under the terms of the GNU Lesser General Public</span> <a name="line-17"></a><span class='hs-comment'>-- License as published by the Free Software Foundation; either</span> <a name="line-18"></a><span class='hs-comment'>-- version 2.1 of the License, or (at your option) any later version.</span> <a name="line-19"></a><span class='hs-comment'>--</span> <a name="line-20"></a><span class='hs-comment'>-- This library is distributed in the hope that it will be useful,</span> <a name="line-21"></a><span class='hs-comment'>-- but WITHOUT ANY WARRANTY; without even the implied warranty of</span> <a name="line-22"></a><span class='hs-comment'>-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span> <a name="line-23"></a><span class='hs-comment'>-- Lesser General Public License for more details.</span> <a name="line-24"></a><span class='hs-comment'>--</span> <a name="line-25"></a><span class='hs-comment'>-- |</span> <a name="line-26"></a><span class='hs-comment'>-- Maintainer : gtk2hs-users@lists.sourceforge.net</span> <a name="line-27"></a><span class='hs-comment'>-- Stability : provisional</span> <a name="line-28"></a><span class='hs-comment'>-- Portability : portable (depends on GHC)</span> <a name="line-29"></a><span class='hs-comment'>--</span> <a name="line-30"></a><span class='hs-comment'>-- Interfaces for drag-and-drop support in 'Graphics.UI.Gtk.ModelView.TreeView'.</span> <a name="line-31"></a><span class='hs-comment'>--</span> <a name="line-32"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>ModelView</span><span class='hs-varop'>.</span><span class='hs-conid'>TreeDrag</span> <span class='hs-layout'>(</span> <a name="line-33"></a> <a name="line-34"></a><span class='hs-comment'>-- * Detail</span> <a name="line-35"></a><span class='hs-comment'>--</span> <a name="line-36"></a><span class='hs-comment'>-- | 'Graphics.UI.Gtk.ModelView.TreeView's provide special support for</span> <a name="line-37"></a><span class='hs-comment'>-- Drag-and-Drop such as hover-to-open-rows or autoscrolling. This module</span> <a name="line-38"></a><span class='hs-comment'>-- implements two utility functions that set and get a path and a model in a</span> <a name="line-39"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.General.Selection.Selection' structure. These functions</span> <a name="line-40"></a><span class='hs-comment'>-- are thus useful to implement drag-and-drop functionality in a</span> <a name="line-41"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.ModelView.TreeModel'. In fact, they are used as part of</span> <a name="line-42"></a><span class='hs-comment'>-- the default drag-and-drop interfaces of</span> <a name="line-43"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.ModelView.ListStore' and</span> <a name="line-44"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.ModelView.TreeStore' that allows to permute rows and move</span> <a name="line-45"></a><span class='hs-comment'>-- them between hierarchy levels.</span> <a name="line-46"></a> <a name="line-47"></a><span class='hs-comment'>-- * DND information for exchanging a model and a path.</span> <a name="line-48"></a> <span class='hs-varid'>treeModelEqual</span><span class='hs-layout'>,</span> <a name="line-49"></a> <span class='hs-varid'>targetTreeModelRow</span><span class='hs-layout'>,</span> <a name="line-50"></a> <span class='hs-varid'>treeGetRowDragData</span><span class='hs-layout'>,</span> <a name="line-51"></a> <span class='hs-varid'>treeSetRowDragData</span><span class='hs-layout'>,</span> <a name="line-52"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-53"></a> <a name="line-54"></a><span class='hs-comment'>-- I've decided not to bind the DragSource and DragDest interfaces. They seem</span> <a name="line-55"></a><span class='hs-comment'>-- to be useful if you (a) write your own 'TreeView' widget or (b) if you</span> <a name="line-56"></a><span class='hs-comment'>-- can't be bothered to implement a special variant of these interfaces in</span> <a name="line-57"></a><span class='hs-comment'>-- ListStore and TreeStore. In the latter case the interfaces are useful to</span> <a name="line-58"></a><span class='hs-comment'>-- "simulate" a drag-and-drop that looks like a row-permutation which is the</span> <a name="line-59"></a><span class='hs-comment'>-- interface that Gtk's ListStore and TreeStore support by default. Since</span> <a name="line-60"></a><span class='hs-comment'>-- overriding or augmenting the dnd interfaces for ListStore and TreeStore is</span> <a name="line-61"></a><span class='hs-comment'>-- so easy in Gtk2Hs, I think we can do without the cheat way.</span> <a name="line-62"></a> <a name="line-63"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>FFI</span> <a name="line-64"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>GObject</span> <a name="line-65"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>Types</span> <a name="line-66"></a><span class='hs-comment'>{-# LINE 60 "./Graphics/UI/Gtk/ModelView/TreeDrag.chs" #-}</span> <a name="line-67"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>ModelView</span><span class='hs-varop'>.</span><span class='hs-conid'>Types</span> <span class='hs-layout'>(</span><span class='hs-conid'>TreePath</span><span class='hs-layout'>,</span> <span class='hs-varid'>fromTreePath</span><span class='hs-layout'>,</span> <span class='hs-varid'>withTreePath</span><span class='hs-layout'>,</span> <a name="line-68"></a> <span class='hs-conid'>NativeTreePath</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-69"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>General</span><span class='hs-varop'>.</span><span class='hs-conid'>DNDTypes</span> <span class='hs-layout'>(</span><span class='hs-conid'>SelectionDataM</span><span class='hs-layout'>,</span> <span class='hs-conid'>SelectionData</span><span class='hs-layout'>,</span> <a name="line-70"></a> <span class='hs-conid'>TargetTag</span><span class='hs-layout'>,</span> <span class='hs-varid'>atomNew</span><span class='hs-layout'>)</span> <a name="line-71"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftM</span><span class='hs-layout'>)</span> <a name="line-72"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Trans</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftIO</span><span class='hs-layout'>)</span> <a name="line-73"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Reader</span> <span class='hs-layout'>(</span><span class='hs-varid'>ask</span><span class='hs-layout'>)</span> <a name="line-74"></a> <a name="line-75"></a> <a name="line-76"></a><span class='hs-comment'>{-# LINE 69 "./Graphics/UI/Gtk/ModelView/TreeDrag.chs" #-}</span> <a name="line-77"></a> <a name="line-78"></a><a name="treeModelEqual"></a><span class='hs-comment'>-- this function is not necessary anymore since the models can be compared</span> <a name="line-79"></a><span class='hs-comment'>-- using equality ==</span> <a name="line-80"></a><span class='hs-definition'>treeModelEqual</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>TreeModelClass</span> <span class='hs-varid'>tm1</span><span class='hs-layout'>,</span> <span class='hs-conid'>TreeModelClass</span> <span class='hs-varid'>tm2</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>tm1</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>tm2</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-81"></a><span class='hs-definition'>treeModelEqual</span> <span class='hs-varid'>tm1</span> <span class='hs-varid'>tm2</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unTreeModel</span> <span class='hs-layout'>(</span><span class='hs-varid'>toTreeModel</span> <span class='hs-varid'>tm1</span><span class='hs-layout'>)</span> <span class='hs-varop'>==</span> <span class='hs-varid'>unTreeModel</span> <span class='hs-layout'>(</span><span class='hs-varid'>toTreeModel</span> <span class='hs-varid'>tm2</span><span class='hs-layout'>)</span> <a name="line-82"></a> <a name="line-83"></a><a name="targetTreeModelRow"></a><span class='hs-comment'>-- | The 'SelectionTag', 'TargetTag' and 'SelectionTypeTag' of the DND</span> <a name="line-84"></a><span class='hs-comment'>-- mechanism of 'Graphics.UI.Gtk.ModelView.ListStore' and</span> <a name="line-85"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.ModelView.TreeStore'. This tag is used by</span> <a name="line-86"></a><span class='hs-comment'>-- 'treeGetRowDragData' and 'treeSetRowDragData' to store a store and a</span> <a name="line-87"></a><span class='hs-comment'>-- 'TreePath' in a 'SelectionDataM'. This target should be added to a</span> <a name="line-88"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.General.Selection.TargetList' using</span> <a name="line-89"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.General.Seleciton.TargetSameWidget' flag and an</span> <a name="line-90"></a><span class='hs-comment'>-- 'Graphics.UI.Gtk.General.Selection.InfoId' of @0@.</span> <a name="line-91"></a><span class='hs-comment'>--</span> <a name="line-92"></a><span class='hs-definition'>targetTreeModelRow</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>TargetTag</span> <a name="line-93"></a><span class='hs-definition'>targetTreeModelRow</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>atomNew</span> <span class='hs-str'>"GTK_TREE_MODEL_ROW"</span> <a name="line-94"></a> <a name="line-95"></a><a name="treeGetRowDragData"></a><span class='hs-comment'>-- %hash c:8dcb d:af3f</span> <a name="line-96"></a><span class='hs-comment'>-- | Obtains a 'TreeModel' and a path from 'SelectionDataM' whenever the target is</span> <a name="line-97"></a><span class='hs-comment'>-- 'targetTreeModelRow'. Normally called from a 'treeDragDestDragDataReceived' handler.</span> <a name="line-98"></a><span class='hs-comment'>--</span> <a name="line-99"></a><span class='hs-definition'>treeGetRowDragData</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>SelectionDataM</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>TreeModel</span><span class='hs-layout'>,</span> <span class='hs-conid'>TreePath</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-100"></a><span class='hs-definition'>treeGetRowDragData</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ask</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>selPtr</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>liftIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>alloca</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>tmPtrPtr</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>alloca</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>pathPtrPtr</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-101"></a> <span class='hs-varid'>isValid</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>liftM</span> <span class='hs-varid'>toBool</span> <span class='hs-varop'>$</span> <a name="line-102"></a> <span class='hs-varid'>gtk_tree_get_row_drag_data</span> <span class='hs-varid'>selPtr</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>tmPtrPtr</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>pathPtrPtr</span><span class='hs-layout'>)</span> <a name="line-103"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>isValid</span> <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <a name="line-104"></a> <span class='hs-varid'>tmPtr</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>tmPtrPtr</span> <a name="line-105"></a> <span class='hs-varid'>pathPtr</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>pathPtrPtr</span> <a name="line-106"></a> <span class='hs-varid'>tm</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>makeNewGObject</span> <span class='hs-varid'>mkTreeModel</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-varid'>tmPtr</span><span class='hs-layout'>)</span> <a name="line-107"></a> <span class='hs-varid'>path</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>fromTreePath</span> <span class='hs-varid'>pathPtr</span> <a name="line-108"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>tm</span><span class='hs-layout'>,</span> <span class='hs-varid'>path</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-109"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Nothing</span> <a name="line-110"></a> <a name="line-111"></a><a name="treeSetRowDragData"></a><span class='hs-comment'>-- %hash c:e3e3 d:af3f</span> <a name="line-112"></a><span class='hs-comment'>-- | Sets selection data with the target 'targetTreeModelRow', consisting</span> <a name="line-113"></a><span class='hs-comment'>-- of a 'TreeModel' and a 'TreePath'. Normally used in a</span> <a name="line-114"></a><span class='hs-comment'>-- 'treeDragSourceDragDataGet' handler.</span> <a name="line-115"></a><span class='hs-comment'>--</span> <a name="line-116"></a><span class='hs-comment'>-- * Returns @True@ if setting the data was successful.</span> <a name="line-117"></a><span class='hs-comment'>--</span> <a name="line-118"></a><span class='hs-definition'>treeSetRowDragData</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>TreeModelClass</span> <span class='hs-varid'>treeModel</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>treeModel</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>TreePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>SelectionDataM</span> <span class='hs-conid'>Bool</span> <a name="line-119"></a><span class='hs-definition'>treeSetRowDragData</span> <span class='hs-varid'>treeModel</span> <span class='hs-varid'>path</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-120"></a> <span class='hs-varid'>selPtr</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>ask</span> <a name="line-121"></a> <span class='hs-varid'>liftM</span> <span class='hs-varid'>toBool</span> <span class='hs-varop'>$</span> <span class='hs-varid'>liftIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>withTreePath</span> <span class='hs-varid'>path</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>path</span> <span class='hs-keyglyph'>-></span> <a name="line-122"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>arg1</span> <span class='hs-layout'>(</span><span class='hs-conid'>TreeModel</span> <span class='hs-varid'>arg2</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>NativeTreePath</span> <span class='hs-varid'>arg3</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>arg2</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>argPtr2</span> <span class='hs-keyglyph'>-></span><span class='hs-varid'>gtk_tree_set_row_drag_data</span> <span class='hs-varid'>arg1</span> <span class='hs-varid'>argPtr2</span> <span class='hs-varid'>arg3</span><span class='hs-layout'>)</span> <span class='hs-varid'>selPtr</span> <a name="line-123"></a> <span class='hs-layout'>(</span><span class='hs-varid'>toTreeModel</span> <span class='hs-varid'>treeModel</span><span class='hs-layout'>)</span> <a name="line-124"></a> <span class='hs-varid'>path</span> <a name="line-125"></a> <a name="line-126"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gtk_tree_get_row_drag_data"</span> <a name="line-127"></a> <span class='hs-varid'>gtk_tree_get_row_drag_data</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>TreeModel</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>NativeTreePath</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-128"></a> <a name="line-129"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gtk_tree_set_row_drag_data"</span> <a name="line-130"></a> <span class='hs-varid'>gtk_tree_set_row_drag_data</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>TreeModel</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>NativeTreePath</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> </pre></body> </html>