拖放函数@GTK+ 2.0 中文教程连载

最新推荐文章于 2022-12-30 16:30:28 发布

大吉机器人

最新推荐文章于 2022-12-30 16:30:28 发布

阅读量852

点赞数

分类专栏： software friendly 文章标签： gtk action button integer table delete

software 同时被 2 个专栏收录

461 篇文章 3 订阅

订阅专栏

friendly

400 篇文章 3 订阅

订阅专栏

属性

拖动数据有下面的这些属性：

拖动行为类型(比如 GDK_ACTION_COPY, GDK_ACTION_MOVE)。
客户端指定的任意拖放类型(一个名称和数字组成的对)。
发送和接收的数据格式类型。

拖动行为的意义很明显，它们指定构件是否能以指定的行为来拖动，比如GDK_ACTION_COPY 和/或GDK_ACTION_MOVE。GDK_ACTION_COPY将是一个典型的拖放，它的源数据并不会被删除，而GDK_ACTION_MOVE 将和GDK_ACTION_COPY一样，只是“建议”在接收信号处理函数调用之后将源数据删除掉。还有一些附加的拖动行为包括 GDK_ACTION_LINK等，当你对拖放的使用达到更高水平时，你可能会使用到。

客户端指定的任意拖放类型要更加灵活些，因为你的程序将明确地定义和检测它。你需要指定一个名称和/或数字以设置目的构件能接收的特定拖放类型。用一个名称要可靠些，因为其它应用程序可能也正好用了同样的数字来区别它的完全不同的类型。

发送和接收的数据格式类型(selection target )只在请求和接收数据处理函数中使用。术语selection target 有些容易令人误解。它应该是一个适合在 GTK+ 选中区(剪切/复制和粘贴)中使用的术语。selection target 实际是指被发送和接收的数据的格式类型(比如GdkAtom, integer, 或string)。你的请求数据处理函数必须指定它发送出去的数据的类型(selection target )，同时接收数据处理函数要处理接收到的数据的类型(selection target )。

函数

设置源构件

gtk_drag_source_set() 函数指定一套在构件上拖动操作时的目标类型。

void gtk_drag_source_set( GtkWidget            *widget,

                          GdkModifierType       start_button_mask,

                          const GtkTargetEntry *targets,

                          gint                  n_targets,

                          GdkDragAction         actions );

这些参数的作用如下：

widget 指定拖动源构件
start_button_mask 指定能引发拖动操作的鼠标按键的位掩码(bitmask)，比如GDK_BUTTON1_MASK
targets 指定一个此拖动支持的目标数据类型的表格
n_targets 指定上面的目标的数量
actions 指定从这个窗口进行拖动时可能的行为的位掩码

targets 参数是一个由下面的结构组成的数组：

struct GtkTargetEntry {

   gchar *target;

   guint  flags;

   guint  info;

 };

这一结构指定一个代表拖动类型的字符串，可选的标记和应用程序指派的整数标识符。

如果一个构件不必再担当拖放操作的源，用gtk_drag_source_unset() 函数可以删除一套拖放目标类型。

void gtk_drag_source_unset( GtkWidget *widget );

源构件上的信号

在一个拖放操作中源构件将被发送下面的这些信号。

Table 1. 源构件的信号

drag_begin	`void (drag_begin)(GtkWidget widget, GdkDragContext *dc, gpointer data)`
drag_motion	`gboolean (drag_motion)(GtkWidget widget, GdkDragContext *dc, gint x, gint y, guint t, gpointer data)`
drag_data_get	`void (drag_data_get)(GtkWidget widget, GdkDragContext dc, GtkSelectionData selection_data, guint info, guint t, gpointer data)`
drag_data_delete	`void (drag_data_delete)(GtkWidget widget, GdkDragContext *dc, gpointer data)`
drag_drop	`gboolean (drag_drop)(GtkWidget widget, GdkDragContext *dc, gint x, gint y, guint t, gpointer data)`
drag_end	`void (drag_end)(GtkWidget widget, GdkDragContext *dc, gpointer data)`

设置目的构件

gtk_drag_dest_set() 指定这个构件可以接收拖动并指定它能接收的拖动的类型。

gtk_drag_dest_unset() 指定构件不再能接收拖动了。

void gtk_drag_dest_set( GtkWidget            *widget,

                        GtkDestDefaults       flags,

                        const GtkTargetEntry *targets,

                        gint                  n_targets,

                        GdkDragAction         actions );



void gtk_drag_dest_unset( GtkWidget *widget );

目的构件上的信号

在一个拖放操作中目的构件将被发送下面的这些信号。

Table 2. 目的构件的信号

drag_data_received void (*drag_data_received)(GtkWidget *widget, GdkDragContext *dc, gint x, gint y, GtkSelectionData *selection_data, guint info, guint t, gpointer data)