<book id="gtk-tut">
<bookinfo>
- <date>July 21st 2000</date>
+ <date>November 21st 2000</date>
<title>GTK+ 1.2 Tutorial</title>
<authorgroup>
<author>
- <firstname>Tony</firstname>
- <surname>Gale</surname>
+ <firstname>Tony</firstname>
+ <surname>Gale</surname>
</author>
<author>
- <firstname>Ian</firstname>
- <surname>Main</surname>
+ <firstname>Ian</firstname>
+ <surname>Main</surname>
</author>
</authorgroup>
<abstract>
<para> This is a tutorial on how to use GTK (the GIMP Toolkit) through its C
- interface.</para>
+ interface.</para>
</abstract>
</bookinfo>
</listitem>
</itemizedlist>
-<para>In order to connect a callback function to one of these events, you
+<para>In order to connect a callback function to one of these events you
use the function gtk_signal_connect, as described above, using one of
the above event names as the <literal>name</literal> parameter. The callback
function for events has a slightly different form than that for
signals:</para>
<programlisting role="C">
-void callback_func( GtkWidget *widget,
+gint callback_func( GtkWidget *widget,
GdkEvent *event,
gpointer callback_data );
</programlisting>
<para>GdkEvent is a C <literal>union</literal> structure whose type will depend upon which
of the above events has occurred. In order for us to tell which event
has been issued each of the possible alternatives has a <literal>type</literal>
-parameter which reflects the event being issued. The other components
+member that reflects the event being issued. The other components
of the event structure will depend upon the type of the
event. Possible values for the type are:</para>
<sect1 id="sec-TheoryOfPackingBoxes">
<title>Theory of Packing Boxes</title>
-<para>Most packing is done by creating boxes as in the example above. These
+<para>Most packing is done by creating boxes. These
are invisible widget containers that we can pack our widgets into
which come in two forms, a horizontal box, and a vertical box. When
packing widgets into a horizontal box, the objects are inserted
<para>You'll notice the extra argument to these calls. They require a group
to perform their duty properly. The first call to
-gtk_radio_button_new_with_label or gtk_radio_button_new_with_label
+gtk_radio_button_new or gtk_radio_button_new_with_label
should pass NULL as the first argument. Then create a group using:</para>
<programlisting role="C">
are:</para>
<itemizedlist>
-<listitem><simpara>GTK_UPDATE_POLICY_CONTINUOUS - This is the default. The
+<listitem><simpara>GTK_UPDATE_CONTINUOUS - This is the default. The
"value_changed" signal is emitted continuously, i.e., whenever the
slider is moved by even the tiniest amount.</simpara>
</listitem>
-<listitem><simpara>GTK_UPDATE_POLICY_DISCONTINUOUS - The "value_changed" signal is
+<listitem><simpara>GTK_UPDATE_DISCONTINUOUS - The "value_changed" signal is
only emitted once the slider has stopped moving and the user has
released the mouse button.</simpara>
</listitem>
-<listitem><simpara>GTK_UPDATE_POLICY_DELAYED - The "value_changed" signal is emitted
+<listitem><simpara>GTK_UPDATE_DELAYED - The "value_changed" signal is emitted
when the user releases the mouse button, or if the slider stops moving
for a short period of time.</simpara>
</listitem>
glist = g_list_append(glist, "String 4");
gtk_combo_set_popdown_strings( GTK_COMBO(combo), glist) ;
+
+ /* can free glist now, combo takes a copy */
</programlisting>
<para>The combo widget makes a copy of the strings passed to it in the glist
<programlisting role="C">
gtk_signal_connect(GTK_OBJECT( clist),
- "select_row"
+ "select_row",
GTK_SIGNAL_FUNC(select_row_callback),
NULL);
</programlisting>
gtk_menu_append (GTK_MENU (file_menu), quit_item);
/* Attach the callback functions to the activate signal */
- gtk_signal_connect_object (GTK_OBJECT (open_items), "activate",
+ gtk_signal_connect_object (GTK_OBJECT (open_item), "activate",
GTK_SIGNAL_FUNC (menuitem_response),
(gpointer) "file.open");
- gtk_signal_connect_object (GTK_OBJECT (save_items), "activate",
+ gtk_signal_connect_object (GTK_OBJECT (save_item), "activate",
GTK_SIGNAL_FUNC (menuitem_response),
(gpointer) "file.save");
/* We can attach the Quit menu item to our exit function */
- gtk_signal_connect_object (GTK_OBJECT (quit_items), "activate",
+ gtk_signal_connect_object (GTK_OBJECT (quit_item), "activate",
GTK_SIGNAL_FUNC (destroy),
(gpointer) "file.quit");
</itemizedlist>
<para>For information about the XInput extension, see the <ulink
-url="http://www.msc.cornell.edu/~otaylor/xinput/XInput-HOWTO.html">XInput-HOWTO</ulink>.</para>
+url="http://www.gtk.org/~otaylor/xinput/howto/index.html">XInput HOWTO</ulink>.</para>
<para>If we examine the full definition of, for example, the GdkEventMotion
structure, we see that it has fields to support extended device
projects / ~andy / gtk / commitdiff