2001-09-08 06:24:46 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkTreeView drag-and-drop
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-02-15 01:47:05 +00:00
|
|
|
Interfaces for drag-and-drop support in GtkTreeView
|
2001-09-08 06:24:46 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2004-02-15 01:47:05 +00:00
|
|
|
GTK+ supports Drag-and-Drop in tree views with a high-level and a low-level
|
|
|
|
API.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
The low-level API consists of the GTK+ DND API, augmented by some treeview
|
|
|
|
utility functions: gtk_tree_view_set_drag_dest_row(),
|
|
|
|
gtk_tree_view_get_drag_dest_row(), gtk_tree_view_get_dest_row_at_pos(),
|
|
|
|
gtk_tree_view_create_row_drag_icon(), gtk_tree_set_row_drag_data() and
|
|
|
|
gtk_tree_get_row_drag_data(). This API leaves a lot of flexibility, but
|
|
|
|
nothing is done automatically, and implementing advanced features like
|
|
|
|
hover-to-open-rows or autoscrolling on top of this API is a lot of work.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
On the other hand, if you write to the high-level API, then all the
|
|
|
|
bookkeeping of rows is done for you, as well as things like hover-to-open
|
|
|
|
and auto-scroll, but your models have to implement the
|
|
|
|
#GtkTreeDragSource and #GtkTreeDragDest interfaces.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2001-09-08 06:24:46 +00:00
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
<!-- ##### STRUCT GtkTreeDragSource ##### -->
|
|
|
|
<para>
|
2001-10-03 04:44:13 +00:00
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkTreeDragSourceIface ##### -->
|
2001-09-08 06:24:46 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
@g_iface:
|
|
|
|
@row_draggable:
|
|
|
|
@drag_data_get:
|
|
|
|
@drag_data_delete:
|
2001-10-03 04:44:13 +00:00
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_drag_source_drag_data_delete ##### -->
|
2001-09-08 06:24:46 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
@drag_source:
|
|
|
|
@path:
|
|
|
|
@Returns:
|
2001-09-08 06:24:46 +00:00
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_drag_source_drag_data_get ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@drag_source:
|
|
|
|
@path:
|
|
|
|
@selection_data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_drag_source_row_draggable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@drag_source:
|
|
|
|
@path:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkTreeDragDest ##### -->
|
2001-09-08 06:24:46 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2001-10-13 05:52:14 +00:00
|
|
|
<!-- ##### STRUCT GtkTreeDragDestIface ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@g_iface:
|
|
|
|
@drag_data_received:
|
|
|
|
@row_drop_possible:
|
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_drag_dest_drag_data_received ##### -->
|
2001-10-13 05:52:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-02-15 01:47:05 +00:00
|
|
|
@drag_dest:
|
|
|
|
@dest:
|
|
|
|
@selection_data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_drag_dest_row_drop_possible ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@drag_dest:
|
|
|
|
@dest_path:
|
|
|
|
@selection_data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_set_row_drag_data ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@selection_data:
|
|
|
|
@tree_model:
|
|
|
|
@path:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_get_row_drag_data ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@selection_data:
|
|
|
|
@tree_model:
|
|
|
|
@path:
|
|
|
|
@Returns:
|
|
|
|
|
2001-10-13 05:52:14 +00:00
|
|
|
|