]> Pileus Git - ~andy/gtk/commitdiff
add example to docs, as people are seeming to have trouble with this
authorJonathan Blandford <jrb@redhat.com>
Fri, 15 Mar 2002 21:47:52 +0000 (21:47 +0000)
committerJonathan Blandford <jrb@src.gnome.org>
Fri, 15 Mar 2002 21:47:52 +0000 (21:47 +0000)
Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>

* gtk/gtktreeviewcolumn.c
(gtk_tree_view_column_new_with_attributes): add example to docs,
as people are seeming to have trouble with this function.

Remake docs as well.

18 files changed:
ChangeLog
ChangeLog.pre-2-0
ChangeLog.pre-2-10
ChangeLog.pre-2-2
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-2-8
docs/reference/gtk/tmpl/gtk-unused.sgml
docs/reference/gtk/tmpl/gtkcelleditable.sgml
docs/reference/gtk/tmpl/gtkeditable.sgml
docs/reference/gtk/tmpl/gtkimagemenuitem.sgml
docs/reference/gtk/tmpl/gtkobject.sgml
docs/reference/gtk/tmpl/gtkrc.sgml
docs/reference/gtk/tmpl/gtksettings.sgml
docs/reference/gtk/tmpl/gtkstyle.sgml
docs/reference/gtk/tmpl/gtktextview.sgml
docs/reference/gtk/tmpl/gtktreesortable.sgml
gtk/gtktreeviewcolumn.c

index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index 6858c150a2222544642a0b12c6c0914e1d14d098..3ae368e71ba0f5f032ee28dac43cd27653b8ce6e 100644 (file)
@@ -1,3 +1,9 @@
+Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtktreeviewcolumn.c
+       (gtk_tree_view_column_new_with_attributes): add example to docs,
+       as people are seeming to have trouble with this function.
+
 2002-03-15  Tor Lillqvist  <tml@iki.fi>
 
        * configure.in: Set MATH_LIB to empty also on Win32.
index cae2b8cb699936c12cc662a15464e62f9df1c484..5cdcf14f3fffc92057dd0a891d4c08840e3ea729 100644 (file)
@@ -285,6 +285,13 @@ has the focus.
 
 @klass: 
 
+<!-- ##### MACRO GTK_OBJECT_CONNECTED ##### -->
+<para>
+Tests whether a #GtkObject has had a signal connected to it.
+</para>
+
+@obj: the object to examine.
+
 <!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
 <para>
 Test whether a GtkObject's arguments have been prepared.
@@ -637,14 +644,6 @@ Control-Return for #GtkText.)
 
 @editable: the object which received the signal.
 
-<!-- ##### SIGNAL GtkEditable::changed ##### -->
-<para>
-Indicates that the user has changed the contents
-of the widget.
-</para>
-
-@editable: the object which received the signal.
-
 <!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
 <para>
 An action signal. Causes the characters in the current selection to
@@ -662,42 +661,6 @@ the widget.
 
 @editable: the object which received the signal.
 
-<!-- ##### SIGNAL GtkEditable::delete-text ##### -->
-<para>
-This signal is emitted when text is deleted from
-the widget by the user. The default handler for
-this signal will normally be responsible for inserting
-the text, so by connecting to this signal and then
-stopping the signal with gtk_signal_emit_stop(), it
-is possible to modify the inserted text, or prevent
-it from being inserted entirely. The @start_pos
-and @end_pos parameters are interpreted as for
-gtk_editable_delete_text()
-</para>
-
-@editable: the object which received the signal.
-@start_pos: the starting position.
-@end_pos: the end position.
-
-<!-- ##### SIGNAL GtkEditable::insert-text ##### -->
-<para>
-This signal is emitted when text is inserted into
-the widget by the user. The default handler for
-this signal will normally be responsible for inserting
-the text, so by connecting to this signal and then
-stopping the signal with gtk_signal_emit_stop(), it
-is possible to modify the inserted text, or prevent
-it from being inserted entirely.
-</para>
-
-@editable: the object which received the signal.
-@new_text: the new text to insert.
-@new_text_length: the length of the new text.
-@position: the position at which to insert the new text.
-           this is an in-out paramter. After the signal
-           emission is finished, it should point after   
-           the newly inserted text.
-
 <!-- ##### SIGNAL GtkEditable::kill-char ##### -->
 <para>
 An action signal. Delete a single character.
@@ -902,6 +865,12 @@ a RC file.
 @filename: filename to load
 @Returns: a #GtkPixmap representing @filename
 
+<!-- ##### STRUCT GtkImageMenuItemClass ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkLabel:accel-keyval ##### -->
 <para>
 
@@ -1090,12 +1059,24 @@ after other user handlers and the default handler.
 @PRIVATE_GTK_DIRECTION_SET: 
 @PRIVATE_GTK_DIRECTION_LTR: 
 
+<!-- ##### STRUCT GtkRcStyleClass ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkScrolledWindow:shadow ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### STRUCT GtkSettingsClass ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
 <para>
 A function which you can use to clean up when the
@@ -1162,12 +1143,65 @@ Holds the data for a statusbar message. <structfield>text</structfield> holds th
 @context_id: 
 @message_id: 
 
+<!-- ##### STRUCT GtkStyleClass ##### -->
+<para>
+
+</para>
+
+@parent_class: 
+@realize: 
+@unrealize: 
+@copy: 
+@clone: 
+@init_from_rc: 
+@set_background: 
+@render_icon: 
+@draw_hline: 
+@draw_vline: 
+@draw_shadow: 
+@draw_polygon: 
+@draw_arrow: 
+@draw_diamond: 
+@draw_string: 
+@draw_box: 
+@draw_flat_box: 
+@draw_check: 
+@draw_option: 
+@draw_tab: 
+@draw_shadow_gap: 
+@draw_box_gap: 
+@draw_extension: 
+@draw_focus: 
+@draw_slider: 
+@draw_handle: 
+@draw_expander: 
+@draw_layout: 
+@draw_resize_grip: 
+@_gtk_reserved1: 
+@_gtk_reserved2: 
+@_gtk_reserved3: 
+@_gtk_reserved4: 
+@_gtk_reserved5: 
+@_gtk_reserved6: 
+@_gtk_reserved7: 
+@_gtk_reserved8: 
+@_gtk_reserved9: 
+@_gtk_reserved10: 
+@_gtk_reserved11: 
+@_gtk_reserved12: 
+
 <!-- ##### STRUCT GtkTextBTreeNode ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### STRUCT GtkTextChildAnchorClass ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkTextTag:justify ##### -->
 <para>
 A #GtkJustification for the text. This is only used when the tag is
@@ -1213,51 +1247,6 @@ produce superscript and subscript.
 </para>
 
 
-<!-- ##### SIGNAL GtkTreeModel::row-changed ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTreeModel::row-deleted ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-
-<!-- ##### SIGNAL GtkTreeModel::row-has-child-toggled ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTreeModel::row-inserted ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTreeModel::rows-reordered ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-@arg3: 
-
 <!-- ##### STRUCT GtkTreeSelectionClass ##### -->
 <para>
 
index 42f7860a6111762b372237c9c4d06d23e669ed48..ec8aae0d54a3e29e46cfdd8301090cc6b5236da6 100644 (file)
@@ -55,3 +55,17 @@ GtkCellEditable
 @cell_editable: 
 
 
+<!-- ##### SIGNAL GtkCellEditable::editing-done ##### -->
+<para>
+
+</para>
+
+@celleditable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCellEditable::remove-widget ##### -->
+<para>
+
+</para>
+
+@celleditable: the object which received the signal.
+
index 0573f87205f6940d4757523dfab45a9851fd2b72..3f890d9e0b2cdb12253932f5b6b7317c5609c27e 100644 (file)
@@ -250,3 +250,47 @@ widget or not.
 @Returns: 
 
 
+<!-- ##### SIGNAL GtkEditable::changed ##### -->
+<para>
+Indicates that the user has changed the contents
+of the widget.
+</para>
+
+@editable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEditable::delete-text ##### -->
+<para>
+This signal is emitted when text is deleted from
+the widget by the user. The default handler for
+this signal will normally be responsible for inserting
+the text, so by connecting to this signal and then
+stopping the signal with gtk_signal_emit_stop(), it
+is possible to modify the inserted text, or prevent
+it from being inserted entirely. The @start_pos
+and @end_pos parameters are interpreted as for
+gtk_editable_delete_text()
+</para>
+
+@editable: the object which received the signal.
+@start_pos: the starting position.
+@end_pos: the end position.
+
+<!-- ##### SIGNAL GtkEditable::insert-text ##### -->
+<para>
+This signal is emitted when text is inserted into
+the widget by the user. The default handler for
+this signal will normally be responsible for inserting
+the text, so by connecting to this signal and then
+stopping the signal with gtk_signal_emit_stop(), it
+is possible to modify the inserted text, or prevent
+it from being inserted entirely.
+</para>
+
+@editable: the object which received the signal.
+@new_text: the new text to insert.
+@new_text_length: the length of the new text.
+@position: the position at which to insert the new text.
+           this is an in-out paramter. After the signal
+           emission is finished, it should point after   
+           the newly inserted text.
+
index 4b5782499f00a9bbf1357f437549619de84f5861..79d86a11681393ee0c8f7c7c0553c6b379f13241 100644 (file)
@@ -20,12 +20,6 @@ GtkImageMenuItem
 </para>
 
 
-<!-- ##### STRUCT GtkImageMenuItemClass ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### FUNCTION gtk_image_menu_item_set_image ##### -->
 <para>
 
index 09b96e28d3837dca81166f87d93be89e94037f2f..e7d68589ec1a9da6b4ee7f8fc30befae30f92069 100644 (file)
@@ -146,14 +146,6 @@ See the overview documentation for #GtkObject.
 @obj: the object to examine.
 
 
-<!-- ##### MACRO GTK_OBJECT_CONNECTED ##### -->
-<para>
-Tests whether a #GtkObject has had a signal connected to it.
-</para>
-
-@obj: the object to examine.
-
-
 <!-- ##### ENUM GtkArgFlags ##### -->
 <para>
 Possible flags indicating how an argument should be treated.
index c8635bb67c061864688203b10fa80a67f5b25399..843af11205b5d82c3fe0db98189cff741a9e838a 100644 (file)
@@ -547,12 +547,6 @@ This can later be composited together with other
 @xthickness: 
 @ythickness: 
 
-<!-- ##### STRUCT GtkRcStyleClass ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### ENUM GtkRcFlags ##### -->
 <para>
 The #GtkRcFlags enumeration is used as a bitmask
index 6a40a5e3b19a4ea0bae384b9cac06399411d51cd..7b04170154f949e8344f7d8463dd15dd5972855a 100644 (file)
@@ -20,12 +20,6 @@ GtkSettings
 </para>
 
 
-<!-- ##### STRUCT GtkSettingsClass ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### STRUCT GtkSettingsValue ##### -->
 <para>
 
index 3f3e9b6f8dda5724b3b0b62827c2196580ae9d74..2f2fb10f64a72b497def77f1c0ee37c76604ae02 100644 (file)
@@ -52,53 +52,6 @@ Returns whether the style is attached to a window.
 @white_gc: 
 @bg_pixmap: 
 
-<!-- ##### STRUCT GtkStyleClass ##### -->
-<para>
-
-</para>
-
-@parent_class: 
-@realize: 
-@unrealize: 
-@copy: 
-@clone: 
-@init_from_rc: 
-@set_background: 
-@render_icon: 
-@draw_hline: 
-@draw_vline: 
-@draw_shadow: 
-@draw_polygon: 
-@draw_arrow: 
-@draw_diamond: 
-@draw_string: 
-@draw_box: 
-@draw_flat_box: 
-@draw_check: 
-@draw_option: 
-@draw_tab: 
-@draw_shadow_gap: 
-@draw_box_gap: 
-@draw_extension: 
-@draw_focus: 
-@draw_slider: 
-@draw_handle: 
-@draw_expander: 
-@draw_layout: 
-@draw_resize_grip: 
-@_gtk_reserved1: 
-@_gtk_reserved2: 
-@_gtk_reserved3: 
-@_gtk_reserved4: 
-@_gtk_reserved5: 
-@_gtk_reserved6: 
-@_gtk_reserved7: 
-@_gtk_reserved8: 
-@_gtk_reserved9: 
-@_gtk_reserved10: 
-@_gtk_reserved11: 
-@_gtk_reserved12: 
-
 <!-- ##### FUNCTION gtk_style_new ##### -->
 <para>
 
index 72742cf1054e72327186bd45475fce788cecbe75..af3f7a7d1c36051a463e0211e283f7bbd1065924 100644 (file)
@@ -329,12 +329,6 @@ types related to the text widget and how they work together.
 </para>
 
 
-<!-- ##### STRUCT GtkTextChildAnchorClass ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### FUNCTION gtk_text_child_anchor_new ##### -->
 <para>
 
index 438e310015f36ab0c5041e96b6d29ba36530fbea..1c9cf1e2ab91f9179e1f5472487290c62e5f0bc3 100644 (file)
@@ -106,3 +106,10 @@ GtkTreeSortable
 @Returns: 
 
 
+<!-- ##### SIGNAL GtkTreeSortable::sort-column-changed ##### -->
+<para>
+
+</para>
+
+@treesortable: the object which received the signal.
+
index 394608ac197c4c54eeff14a6ed3bd90a596fd6a1..666f25d47317ef2a81fce36489ef79232bdecac3 100644 (file)
@@ -1075,6 +1075,22 @@ gtk_tree_view_column_new (void)
  * equivalent to calling gtk_tree_view_column_set_title(),
  * gtk_tree_view_column_pack_start(), and
  * gtk_tree_view_column_set_attributes() on the newly created #GtkTreeViewColumn.
+ *
+ * Here's a simple example:
+ * <informalexample><programlisting>
+ *  <!>enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
+ *  <!>...
+ *  <!>{
+ *  <!>  GtkTreeViewColumn *column;
+ *  <!>  GtkCellRenderer   *renderer = gtk_cell_renderer_text_new ();
+ *  <!>
+ *  <!>  column = gtk_tree_view_column_new_with_attributes ("Title",
+ *  <!>                                                     renderer,
+ *  <!>                                                     "text", TEXT_COLUMN,
+ *  <!>                                                     "foreground", COLOR_COLUMN,
+ *  <!>                                                     NULL);
+ *  <!>}
+ * </programlisting></informalexample>
  * 
  * Return value: A newly created #GtkTreeViewColumn.
  **/