📄 x2259.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"><HTML><HEAD><TITLE>从头创建构件</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="GTK+ 2.0 教程"HREF="book1.html"><LINKREL="UP"TITLE="编写你自己的构件"HREF="c2132.html"><LINKREL="PREVIOUS"TITLE="创建一个复合构件"HREF="x2152.html"><LINKREL="NEXT"TITLE="深入的学习"HREF="x2367.html"></HEAD><BODYCLASS="SECT1"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">GTK+ 2.0 教程</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="x2152.html"ACCESSKEY="P"><<< Previous</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom">编写你自己的构件</TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="x2367.html"ACCESSKEY="N">Next >>></A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="SECT1"><H1CLASS="SECT1"><ANAME="SEC-CREATINGAWIDGETFROMSCRATCH">从头创建构件</H1><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN2261">介绍</H2><P>在这一节，我们将学习如何让构件把自己显示在屏幕上，以及如何让构件与事件交互。期间，我们将做一个表盘构件，用户可以拖动表盘上的指针来设定值。</P><P><SPANCLASS="INLINEMEDIAOBJECT"><IMGSRC="images/gtkdial.png"></SPAN></P></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN2268">在屏幕上显示构件</H2><P>在屏幕上显示需要几个相关步骤。在调用 <TTCLASS="LITERAL">WIDGETNAME_new()</TT> 创建构件之后，如下几个函数需要用到：</P><P></P><UL><LI><P> <TTCLASS="LITERAL">WIDGETNAME_realize()</TT> 如果构件有 X 窗口，该函数负责为构件创建 X 窗口。</P></LI><LI><P> <TTCLASS="LITERAL">WIDGETNAME_map()</TT> 在用户调用 <TTCLASS="LITERAL">gtk_widget_show()</TT> 之后会调用该函数。它负责确保构件绘制在屏幕上。对于容器类，该函数必须调用每个子构件的 <TTCLASS="LITERAL">map()</TT> 函数。</P></LI><LI><P> <TTCLASS="LITERAL">WIDGETNAME_draw()</TT> 当为构件或它的一个祖先调用 <TTCLASS="LITERAL">gtk_widget_draw()</TT> 时该函数被调用。它实际上是调用绘制函数在屏幕上绘制构件。对于容器构件，该函数必须为它的子构件调用 <TTCLASS="LITERAL">gtk_widget_draw()</TT>。</P></LI><LI><P> <TTCLASS="LITERAL">WIDGETNAME_expose()</TT> 是构件的暴露事件处理函数。它调用绘制函数把暴露的部分绘制在屏幕上。对于容器构件，该函数必须为无窗口子构件产生暴露事件。(如果它们有自己的窗口，X 会产生必需的暴露事件。)</P></LI></UL><P>你可能注意到后面的两个函数十分相似，都是负责在屏幕上绘制构件。实际上许多构件并不真正关心它们之间的不同。构件类里的默认 <TTCLASS="LITERAL">draw()</TT> 函数只是简单的为重绘区域产生一个暴露事件。然而，一些构件通过区分这两个函数可以减少操作。例如，如果一个构件有多个 X 窗口，因为暴露事件标识了暴露的窗口，它可以只重绘受影响的窗口，调用 <TTCLASS="LITERAL">draw()</TT> 是不可能这样的。</P><P>容器构件，即使它们自身并不关心这个差别，也不能简单的使用默认 <TTCLASS="LITERAL">draw()</TT> 函数，因为它的子构件可能需要注意这个差别。然而，在两个函数里重复绘制代码是一种浪费的。按惯例，构件有一个名为 <TTCLASS="LITERAL">WIDGETNAME_paint()</TT> 的函数做实际的绘制构件的工作，<TTCLASS="LITERAL">draw()</TT> 和 <TTCLASS="LITERAL">expose()</TT> 函数再调用它。</P><P>在我们的示例里，因为表盘构件不是一个容器构件，并且只有一个窗口，我们采用最简便的方法，用默认的 <TTCLASS="LITERAL">draw()</TT> 函数，并且仅仅实现一个 <TTCLASS="LITERAL">expose()</TT> 函数。</P></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN2300">表盘构件的原形</H2><P>正像陆上动物是从泥里爬出的两栖动物的变体，GTK 构件是其它的、以前写的构件的变体。因此，虽然这个章节命名为“从头创建构件”，但表盘构件实际上是从范围构件的源码上开始的。以它为起点是因为如果我们的表盘构件能与比例构件有相同的接口会好一些，比例构件是范围构件的继承。所以，虽然源代码在下面以完整的形式出现，它不能说是<ICLASS="EMPHASIS">从头</I>写出来的。如果你还不熟悉比例构件如何以应用程序作者的观点来运作，最好先看一下前面的章节。</P></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN2304">主体</H2><P>我们的构件中的相当多的一部分看起来与井字游戏构件十分相似。首先，我们有一个头文件：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING"> /* GTK - GIMP工具包 * 版权 (C) 1995-1997 Peter Mattis, Spencer Kimball 和 Josh MacDonald 所有 * * 本程序是自由软件。你可以在自由软件基金发布的 GNU GPL 的条款下重新分发 * 或修改它。GPL 可以使用版本 2 或(由你选择)任何随后的版本。 * * 本程序分发的目的是它可能对其他人有用，但不提供任何的担保，包括隐含的 * 和适合特定用途的保证。请查阅GNU通用公共许可证获得详细的信息。 * * 你应该已经随该软件一起收到一份GNU通用公共许可。如果还没有，请写信给 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */#ifndef __GTK_DIAL_H__#define __GTK_DIAL_H__#include <gdk/gdk.h>#include <gtk/gtkadjustment.h>#include <gtk/gtkwidget.h>#ifdef __cplusplusextern "C" {#endif /* __cplusplus */#define GTK_DIAL(obj) GTK_CHECK_CAST (obj, gtk_dial_get_type (), GtkDial)#define GTK_DIAL_CLASS(klass) GTK_CHECK_CLASS_CAST (klass, gtk_dial_get_type (), GtkDialClass)#define GTK_IS_DIAL(obj) GTK_CHECK_TYPE (obj, gtk_dial_get_type ())typedef struct _GtkDial GtkDial;typedef struct _GtkDialClass GtkDialClass;struct _GtkDial{ GtkWidget widget; /* 更新方式 (GTK_UPDATE_[CONTINUOUS/DELAYED/DISCONTINUOUS]) */ guint policy : 2; /* 当前按下的按钮，如果没有该值是 0 */ guint8 button; /* 表盘指针的大小 */ gint radius; gint pointer_width; /* 更新计时器的ID , 如果没有该值是 0 */ guint32 timer; /* 当前角度 */ gfloat angle; /* 将从调整对象中得到的旧值保存起来，这样在改变时我们就会知道 */ gfloat old_value; gfloat old_lower; gfloat old_upper; /* 为这个表盘构件存储数据的调整对象 */ GtkAdjustment *adjustment;};struct _GtkDialClass{ GtkWidgetClass parent_class;};GtkWidget* gtk_dial_new (GtkAdjustment *adjustment);GtkType gtk_dial_get_type (void);GtkAdjustment* gtk_dial_get_adjustment (GtkDial *dial);void gtk_dial_set_update_policy (GtkDial *dial, GtkUpdateType policy);void gtk_dial_set_adjustment (GtkDial *dial, GtkAdjustment *adjustment);#ifdef __cplusplus}#endif /* __cplusplus */#endif /* __GTK_DIAL_H__ */</PRE></TD></TR></TABLE><P>因为相对于上一个构件，这个构件我们要做的工作更多，所以在数据结构里有更多的域，但是其它地方一样。</P><P>接下来，在包含了头文件和声明了几个常量之后，我们有几个提供构件信息的函数和初始化构件的函数：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">#include <math.h>#include <stdio.h>#include <gtk/gtkmain.h>#include <gtk/gtksignal.h>#include "gtkdial.h"#define SCROLL_DELAY_LENGTH 300#define DIAL_DEFAULT_SIZE 100/* 声明 */[ 省略以节省空间 ]/* 局部数据 */static GtkWidgetClass *parent_class = NULL;GtkTypegtk_dial_get_type (){ static GtkType dial_type = 0; if (!dial_type) { static const GtkTypeInfo dial_info = { "GtkDial", sizeof (GtkDial), sizeof (GtkDialClass), (GtkClassInitFunc) gtk_dial_class_init, (GtkObjectInitFunc) gtk_dial_init, /* reserved_1 */ NULL, /* reserved_1 */ NULL, (GtkClassInitFunc) NULL }; dial_type = gtk_type_unique (GTK_TYPE_WIDGET, &dial_info); } return dial_type;}static voidgtk_dial_class_init (GtkDialClass *class){ GtkObjectClass *object_class; GtkWidgetClass *widget_class; object_class = (GtkObjectClass*) class; widget_class = (GtkWidgetClass*) class; parent_class = gtk_type_class (gtk_widget_get_type ()); object_class->destroy = gtk_dial_destroy; widget_class->realize = gtk_dial_realize; widget_class->expose_event = gtk_dial_expose; widget_class->size_request = gtk_dial_size_request; widget_class->size_allocate = gtk_dial_size_allocate; widget_class->button_press_event = gtk_dial_button_press; widget_class->button_release_event = gtk_dial_button_release; widget_class->motion_notify_event = gtk_dial_motion_notify;}static voidgtk_dial_init (GtkDial *dial){ dial->button = 0; dial->policy = GTK_UPDATE_CONTINUOUS; dial->timer = 0; dial->radius = 0; dial->pointer_width = 0; dial->angle = 0.0; dial->old_value = 0.0; dial->old_lower = 0.0; dial->old_upper = 0.0; dial->adjustment = NULL;}GtkWidget*gtk_dial_new (GtkAdjustment *adjustment){ GtkDial *dial; dial = gtk_type_new (gtk_dial_get_type ()); if (!adjustment) adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0); gtk_dial_set_adjustment (dial, adjustment); return GTK_WIDGET (dial);}static voidgtk_dial_destroy (GtkObject *object){ GtkDial *dial; g_return_if_fail (object != NULL); g_return_if_fail (GTK_IS_DIAL (object)); dial = GTK_DIAL (object); if (dial->adjustment) gtk_object_unref (GTK_OBJECT (dial->adjustment)); if (GTK_OBJECT_CLASS (parent_class)->destroy) (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);}</PRE></TD></TR></TABLE><P>注意 <TTCLASS="LITERAL">init()</TT> 函数所做的工作比井字游戏构件少，因为这个构件不是复合构件，<TTCLASS="LITERAL">new()</TT> 函数所做的工作多一些，因为现在它具有一个参数。还要注意，当我们存储一个到调整对象的指针的时候，我们增加它的引用计数，(并在不再使用它的时候相应的减少它)，这样 GTK 就能明了在何时可以安全的销毁这个对象。</P><P>还有几个操作构件选项的函数：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">GtkAdjustment*gtk_dial_get_adjustment (GtkDial *dial){ g_return_val_if_fail (dial != NULL, NULL); g_return_val_if_fail (GTK_IS_DIAL (dial), NULL); return dial->adjustment;}voidgtk_dial_set_update_policy (GtkDial *dial, GtkUpdateType policy){ g_return_if_fail (dial != NULL); g_return_if_fail (GTK_IS_DIAL (dial)); dial->policy = policy;}voidgtk_dial_set_adjustment (GtkDial *dial, GtkAdjustment *adjustment){ g_return_if_fail (dial != NULL); g_return_if_fail (GTK_IS_DIAL (dial)); if (dial->adjustment) { gtk_signal_disconnect_by_data (GTK_OBJECT (dial->adjustment), (gpointer) dial); gtk_object_unref (GTK_OBJECT (dial->adjustment)); } dial->adjustment = adjustment; gtk_object_ref (GTK_OBJECT (dial->adjustment)); gtk_signal_connect (GTK_OBJECT (adjustment), "changed", (GtkSignalFunc) gtk_dial_adjustment_changed, (gpointer) dial); gtk_signal_connect (GTK_OBJECT (adjustment), "value_changed", (GtkSignalFunc) gtk_dial_adjustment_value_changed, (gpointer) dial); dial->old_value = adjustment->value; dial->old_lower = adjustment->lower; dial->old_upper = adjustment->upper; gtk_dial_update (dial);}</PRE></TD></TR></TABLE></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><ANAME="AEN2316"><TTCLASS="LITERAL">gtk_dial_realize()</TT></H2><P>现在我们来看几个新的函数。第一个是创建 X 窗口的函数。注意有一个掩码传递给函数 <TTCLASS="LITERAL">gdk_window_new()</TT>，它指出 GdkWindowAttr 结构的哪些域实际上有数据在里面(其余的值会设为默认值)。同时也应该注意创建构件的事件掩码的方法。我们调用 <TTCLASS="LITERAL">gtk_widget_get_events()</TT> 去获取用户为这个构件设置的事件掩码 (用 <TTCLASS="LITERAL">gtk_widget_set_events()</TT> )，并把我们需要的事件加入其中。</P><P>创建窗口之后，我们设置它的风格和背景，并把指向构件的指针放入 GdkWindow 的用户数据域。最后一步允许 GTK 分派这个窗口的事件到正确的构件。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">static voidgtk_dial_realize (GtkWidget *widget){ GtkDial *dial; GdkWindowAttr attributes; gint attributes_mask; g_return_if_fail (widget != NULL); g_return_if_fail (GTK_IS_DIAL (widget)); GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED); dial = GTK_DIAL (widget); attributes.x = widget->allocation.x; attributes.y = widget->allocation.y; attributes.width = widget->allocation.width; attributes.height = widget->allocation.height; attributes.wclass = GDK_INPUT_OUTPUT; attributes.window_type = GDK_WINDOW_CHILD; attributes.event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK | GDK_POINTER_MOTION_MASK | GDK_POINTER_MOTION_HINT_MASK; attributes.visual = gtk_widget_get_visual (widget); attributes.colormap = gtk_widget_get_colormap (widget); attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP; widget->window = gdk_window_new (widget->parent->window, &attributes, attributes_mask); widget->style = gtk_style_attach (widget->style, widget->window); gdk_window_set_user_data (widget->window, widget); gtk_style_set_background (widget->style, widget->window, GTK_STATE_ACTIVE);}</PRE></TD></TR></TABLE></DIV><DIVCLASS="SECT2"><H2CLASS="SECT2"><A⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -