diff options
author | GMT 2000 Tony Gale <gale@gtk.org> | 2000-11-21 14:19:15 +0000 |
---|---|---|
committer | Tony Gale <gale@src.gnome.org> | 2000-11-21 14:19:15 +0000 |
commit | ac22e4f8b4f71d3e7d9775fc26fcb9013f339209 (patch) | |
tree | c79c109104257b7d648b6cb24c96a90219e03eb0 /docs | |
parent | 7a2e1974f0e509620bd329aa5f0b00ab388280b4 (diff) | |
download | gtk+-ac22e4f8b4f71d3e7d9775fc26fcb9013f339209.tar.gz |
minor corrections
Tue Nov 21 14:17:51 GMT 2000 Tony Gale <gale@gtk.org>
* docs/tutorial/gtk-tut.sgml: minor corrections
Diffstat (limited to 'docs')
-rwxr-xr-x | docs/tutorial/gtk-tut.sgml | 40 |
1 files changed, 21 insertions, 19 deletions
diff --git a/docs/tutorial/gtk-tut.sgml b/docs/tutorial/gtk-tut.sgml index 20373f36e9..5a95946ebb 100755 --- a/docs/tutorial/gtk-tut.sgml +++ b/docs/tutorial/gtk-tut.sgml @@ -2,21 +2,21 @@ <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> @@ -554,14 +554,14 @@ also be attached to these events. These events are:</para> </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> @@ -569,7 +569,7 @@ void callback_func( GtkWidget *widget, <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> @@ -1084,7 +1084,7 @@ This is where packing comes in.</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 @@ -2290,7 +2290,7 @@ GtkWidget *gtk_radio_button_new_with_label( GSList *group, <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"> @@ -2823,17 +2823,17 @@ Adjustment. The update policies, defined in 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> @@ -5686,6 +5686,8 @@ pointer to the GList.</para> 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 @@ -9225,7 +9227,7 @@ void select_row_callback(GtkWidget *widget, <programlisting role="C"> gtk_signal_connect(GTK_OBJECT( clist), - "select_row" + "select_row", GTK_SIGNAL_FUNC(select_row_callback), NULL); </programlisting> @@ -10615,15 +10617,15 @@ standard <literal>File</literal> menu, with the options <literal>Open</literal>, 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"); @@ -15510,7 +15512,7 @@ such as:</para> </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 |