diff options
Diffstat (limited to 'docs')
19 files changed, 2110 insertions, 5 deletions
diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am index 7fce973534..bb7f4850b5 100644 --- a/docs/reference/gtk/Makefile.am +++ b/docs/reference/gtk/Makefile.am @@ -22,6 +22,9 @@ IGNORE_HFILES= \ gtkintl.h \ gtkmarshal.h \ gtkprivate.h \ + gtktreeprivate.h \ + gtkrbtree.h \ + gtktreedatalist.h \ gtktextbtree.h \ gtktextchild.h \ gtktextdisplay.h \ diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml index 7102f5b191..d088966cac 100644 --- a/docs/reference/gtk/gtk-docs.sgml +++ b/docs/reference/gtk/gtk-docs.sgml @@ -54,6 +54,7 @@ <!entity GtkMenuBar SYSTEM "sgml/gtkmenubar.sgml"> <!entity GtkMenuItem SYSTEM "sgml/gtkmenuitem.sgml"> <!entity GtkMenuShell SYSTEM "sgml/gtkmenushell.sgml"> +<!entity gtk-GtkMessageDialog SYSTEM "sgml/gtkmessagedialog.sgml"> <!entity GtkMisc SYSTEM "sgml/gtkmisc.sgml"> <!entity GtkNotebook SYSTEM "sgml/gtknotebook.sgml"> <!entity GtkObject SYSTEM "sgml/gtkobject.sgml"> @@ -91,6 +92,18 @@ <!entity GtkTooltips SYSTEM "sgml/gtktooltips.sgml"> <!entity GtkTree SYSTEM "sgml/gtktree.sgml"> <!entity GtkTreeItem SYSTEM "sgml/gtktreeitem.sgml"> +<!entity gtk-gtktreemodel SYSTEM "sgml/gtktreemodel.sgml"> +<!entity gtk-GtkTreeSelection SYSTEM "sgml/gtktreeselection.sgml"> +<!entity gtk-GtkTreeStore SYSTEM "sgml/gtktreestore.sgml"> +<!entity gtk-GtkTreeViewColumn SYSTEM "sgml/gtktreeviewcolumn.sgml"> +<!entity gtk-GtkTreeView SYSTEM "sgml/gtktreeview.sgml"> +<!entity gtk-GtkModelSimple SYSTEM "sgml/gtkmodelsimple.sgml"> +<!entity gtk-GtkCellRenderer SYSTEM "sgml/gtkcellrenderer.sgml"> +<!entity gtk-GtkCellRendererPixbuf SYSTEM "sgml/gtkcellrendererpixbuf.sgml"> +<!entity gtk-GtkCellRendererText SYSTEM "sgml/gtkcellrenderertext.sgml"> +<!entity gtk-GtkCellRendererTextPixbuf SYSTEM "sgml/gtkcellrenderertextpixbuf.sgml"> +<!entity gtk-GtkCellRendererToggle SYSTEM "sgml/gtkcellrenderertoggle.sgml"> +<!entity gtk-GtkListStore SYSTEM "sgml/gtkliststore.sgml"> <!entity GtkVButtonBox SYSTEM "sgml/gtkvbbox.sgml"> <!entity GtkVBox SYSTEM "sgml/gtkvbox.sgml"> <!entity GtkViewport SYSTEM "sgml/gtkviewport.sgml"> @@ -109,6 +122,7 @@ <!entity gtk-Resource-Files SYSTEM "sgml/gtkrc.sgml"> <!entity gtk-Keyboard-Accelerators SYSTEM "sgml/gtkaccelgroup.sgml"> <!entity gtk-Selections SYSTEM "sgml/gtkselection.sgml"> +<!entity gtk-Clipboards SYSTEM "sgml/gtkclipboard.sgml"> <!entity gtk-Drag-and-Drop SYSTEM "sgml/gtkdnd.sgml"> <!entity gtk-Signals SYSTEM "sgml/gtksignal.sgml"> <!entity gtk-Object-Properties SYSTEM "sgml/gtkarg.sgml"> @@ -120,6 +134,7 @@ <!entity index-Objects-Grouped SYSTEM "objects_grouped.sgml"> <!entity gtk-TextWidget SYSTEM "text_widget.sgml"> +<!entity gtk-TreeWidget SYSTEM "tree_widget.sgml"> ]> <book id="index"> <bookinfo> @@ -244,7 +259,22 @@ An advanced widget set. &GtkTextView; </sect1> - + <sect1 id="TreeWidgetObjects"> + <title>Tree and List Widget</title> + >k-TreeWidget; + >k-gtktreemodel; + >k-GtkTreeSelection; + >k-GtkTreeStore; + >k-GtkTreeViewColumn; + >k-GtkTreeView; + >k-GtkModelSimple; + >k-GtkCellRenderer; + >k-GtkCellRendererPixbuf; + >k-GtkCellRendererText; + >k-GtkCellRendererTextPixbuf; + >k-GtkCellRendererToggle; + >k-GtkListStore; + </sect1> <sect1 id="MenusAndCombos"> <title>Menus, Combo Box, Toolbar</title> &GtkCheckMenuItem; diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt index 379484370d..f1bfa9cdf9 100644 --- a/docs/reference/gtk/gtk-sections.txt +++ b/docs/reference/gtk/gtk-sections.txt @@ -2304,6 +2304,302 @@ GTK_TREE_ITEM_GET_CLASS </SECTION> <SECTION> +<FILE>gtktreemodel</FILE> +<TITLE>GtkTreeModel</TITLE> +GTK_TREE_MODEL_GET_IFACE +GtkTreeIter +GtkTreePath +GtkTreeModel +GtkTreeModelIface +gtk_tree_path_new +gtk_tree_path_new_from_string +gtk_tree_path_to_string +gtk_tree_path_new_root +gtk_tree_path_append_index +gtk_tree_path_prepend_index +gtk_tree_path_get_depth +gtk_tree_path_get_indices +gtk_tree_path_free +gtk_tree_path_copy +gtk_tree_path_compare +gtk_tree_path_next +gtk_tree_path_prev +gtk_tree_path_up +gtk_tree_path_down +gtk_tree_model_get_n_columns +gtk_tree_model_get_column_type +gtk_tree_model_get_iter +gtk_tree_model_get_path +gtk_tree_model_get_value +gtk_tree_model_iter_next +gtk_tree_model_iter_children +gtk_tree_model_iter_has_child +gtk_tree_model_iter_n_children +gtk_tree_model_iter_nth_child +gtk_tree_model_iter_parent +<SUBSECTION Standard> +GTK_TREE_MODEL +GTK_IS_TREE_MODEL +GTK_TYPE_TREE_MODEL +gtk_tree_model_get_type +</SECTION> + +<SECTION> +<FILE>gtktreeselection</FILE> +GtkTreeSelectionType +GtkTreeSelectionFunc +GtkTreeSelectionForeachFunc +<TITLE>GtkTreeSelection</TITLE> +gtk_tree_selection_new +gtk_tree_selection_set_type +gtk_tree_selection_set_select_function +gtk_tree_selection_get_user_data +gtk_tree_selection_get_selected +gtk_tree_selection_selected_foreach +gtk_tree_selection_select_path +gtk_tree_selection_unselect_path +gtk_tree_selection_select_iter +gtk_tree_selection_unselect_iter +gtk_tree_selection_select_all +gtk_tree_selection_unselect_all +gtk_tree_selection_select_range +gtk_tree_selection_new_with_tree_view +gtk_tree_selection_set_tree_view +<SUBSECTION Standard> +GTK_TREE_SELECTION +GTK_IS_TREE_SELECTION +GTK_TYPE_TREE_SELECTION +gtk_tree_selection_get_type +GTK_TREE_SELECTION_CLASS +GTK_IS_TREE_SELECTION_CLASS +</SECTION> + +<SECTION> +<FILE>gtktreestore</FILE> +<TITLE>GtkTreeStore</TITLE> +GtkTreeStore +gtk_tree_store_new +gtk_tree_store_new_with_values +gtk_tree_store_set_n_columns +gtk_tree_store_set_column_type +gtk_tree_store_set_cell +gtk_tree_store_set +gtk_tree_store_setv +gtk_tree_store_get +gtk_tree_store_getv +gtk_tree_store_remove +gtk_tree_store_insert +gtk_tree_store_insert_before +gtk_tree_store_insert_after +gtk_tree_store_prepend +gtk_tree_store_append +gtk_tree_store_get_root_iter +gtk_tree_store_is_ancestor +gtk_tree_store_iter_depth +<SUBSECTION Standard> +GTK_TREE_STORE +GTK_IS_TREE_STORE +GTK_TYPE_TREE_STORE +gtk_tree_store_get_type +GTK_TREE_STORE_CLASS +GTK_IS_TREE_STORE_CLASS +</SECTION> + +<SECTION> +<FILE>gtktreeviewcolumn</FILE> +GTK_TYPE_TREE_COLUMN +GtkTreeViewColumn +GtkTreeViewColumnType +GtkTreeViewColumnFunc +<TITLE>GtkTreeViewColumn</TITLE> +gtk_tree_view_column_new +gtk_tree_view_column_new_with_attributes +gtk_tree_view_column_set_cell_renderer +gtk_tree_view_column_add_attribute +gtk_tree_view_column_set_attributes +gtk_tree_view_column_set_cell_data +gtk_tree_view_column_set_visible +gtk_tree_view_column_get_visible +gtk_tree_view_column_set_col_type +gtk_tree_view_column_get_col_type +gtk_tree_view_column_get_size +gtk_tree_view_column_set_size +gtk_tree_view_column_set_min_width +gtk_tree_view_column_get_min_width +gtk_tree_view_column_set_max_width +gtk_tree_view_column_get_max_width +gtk_tree_view_column_set_title +gtk_tree_view_column_get_title +gtk_tree_view_column_set_header_active +gtk_tree_view_column_set_widget +gtk_tree_view_column_get_widget +gtk_tree_view_column_set_justification +gtk_tree_view_column_get_justification +<SUBSECTION Standard> +GTK_TREE_VIEW_COLUMN +GTK_IS_TREE_VIEW_COLUMN +gtk_tree_view_column_get_type +GTK_TREE_VIEW_COLUMN_CLASS +GTK_IS_TREE_VIEW_COLUMN_CLASS +</SECTION> + +<SECTION> +<FILE>gtktreeview</FILE> +GtkTreeView +GtkTreeSelection +GtkTreeSelectionClass +<TITLE>GtkTreeView</TITLE> +gtk_tree_view_new +gtk_tree_view_new_with_model +gtk_tree_view_get_model +gtk_tree_view_set_model +gtk_tree_view_get_selection +gtk_tree_view_get_hadjustment +gtk_tree_view_set_hadjustment +gtk_tree_view_get_vadjustment +gtk_tree_view_set_vadjustment +gtk_tree_view_get_headers_visible +gtk_tree_view_set_headers_visible +gtk_tree_view_columns_autosize +gtk_tree_view_set_headers_active +gtk_tree_view_append_column +gtk_tree_view_remove_column +gtk_tree_view_insert_column +gtk_tree_view_get_column +gtk_tree_view_move_to +gtk_tree_view_get_path_at_pos +gtk_tree_view_expand_all +gtk_tree_view_collapse_all +gtk_tree_view_expand_row +gtk_tree_view_collapse_row +<SUBSECTION Standard> +GTK_TREE_VIEW +GTK_IS_TREE_VIEW +GTK_TYPE_TREE_VIEW +gtk_tree_view_get_type +GTK_TREE_VIEW_CLASS +GTK_IS_TREE_VIEW_CLASS +<SUBSECTION Private> +GtkTreeViewPrivate +</SECTION> + +<SECTION> +<FILE>gtkmodelsimple</FILE> +<TITLE>GtkModelSimple</TITLE> +gtk_model_simple_new +gtk_model_simple_node_changed +gtk_model_simple_node_inserted +gtk_model_simple_node_child_toggled +gtk_model_simple_node_deleted +<SUBSECTION Standard> +GTK_MODEL_SIMPLE +GTK_IS_MODEL_SIMPLE +GTK_TYPE_MODEL_SIMPLE +gtk_model_simple_get_type +GTK_MODEL_SIMPLE_CLASS +GTK_IS_MODEL_SIMPLE_CLASS +</SECTION> + +<SECTION> +<FILE>gtkcellrenderer</FILE> +GtkCellRendererType +<TITLE>GtkCellRenderer</TITLE> +GtkCellRenderer +gtk_cell_renderer_get_size +gtk_cell_renderer_render +gtk_cell_renderer_event +<SUBSECTION Standard> +GTK_CELL_RENDERER +GTK_IS_CELL_RENDERER +GTK_TYPE_CELL_RENDERER +gtk_cell_renderer_get_type +GTK_CELL_RENDERER_CLASS +GTK_IS_CELL_RENDERER_CLASS +GTK_CELL_RENDERER_GET_CLASS +</SECTION> + +<SECTION> +<FILE>gtkcellrendererpixbuf</FILE> +<TITLE>GtkCellRendererPixbuf</TITLE> +GtkCellRendererPixbuf +gtk_cell_renderer_pixbuf_new +<SUBSECTION Standard> +GTK_CELL_RENDERER_PIXBUF +GTK_IS_CELL_RENDERER_PIXBUF +GTK_TYPE_CELL_RENDERER_PIXBUF +gtk_cell_renderer_pixbuf_get_type +GTK_CELL_RENDERER_PIXBUF_CLASS +GTK_IS_CELL_RENDERER_PIXBUF_CLASS +</SECTION> + +<SECTION> +<FILE>gtkcellrenderertext</FILE> +<TITLE>GtkCellRendererText</TITLE> +GtkCellRendererText +gtk_cell_renderer_text_new +<SUBSECTION Standard> +GTK_CELL_RENDERER_TEXT +GTK_IS_CELL_RENDERER_TEXT +GTK_TYPE_CELL_RENDERER_TEXT +gtk_cell_renderer_text_get_type +GTK_CELL_RENDERER_TEXT_CLASS +GTK_IS_CELL_RENDERER_TEXT_CLASS +</SECTION> + +<SECTION> +<FILE>gtkcellrenderertextpixbuf</FILE> +<TITLE>GtkCellRendererTextPixbuf</TITLE> +GtkCellRendererTextPixbuf +gtk_cell_renderer_text_pixbuf_new +<SUBSECTION Standard> +GTK_CELL_RENDERER_TEXT_PIXBUF +GTK_IS_CELL_RENDERER_TEXT_PIXBUF +GTK_TYPE_CELL_RENDERER_TEXT_PIXBUF +gtk_cell_renderer_text_pixbuf_get_type +GTK_CELL_RENDERER_TEXT_PIXBUF_CLASS +GTK_IS_CELL_RENDERER_TEXT_PIXBUF_CLASS +</SECTION> + +<SECTION> +<FILE>gtkcellrenderertoggle</FILE> +<TITLE>GtkCellRendererToggle</TITLE> +GtkCellRendererToggle +gtk_cell_renderer_toggle_new +gtk_cell_renderer_toggle_set_radio +<SUBSECTION Standard> +GTK_CELL_RENDERER_TOGGLE +GTK_IS_CELL_RENDERER_TOGGLE +GTK_TYPE_CELL_RENDERER_TOGGLE +gtk_cell_renderer_toggle_get_type +GTK_CELL_RENDERER_TOGGLE_CLASS +GTK_IS_CELL_RENDERER_TOGGLE_CLASS +</SECTION> + +<SECTION> +<FILE>gtkliststore</FILE> +<TITLE>GtkListStore</TITLE> +GtkListStore +gtk_list_store_new +gtk_list_store_new_with_types +gtk_list_store_set_n_columns +gtk_list_store_set_column_type +gtk_list_store_set_cell +gtk_list_store_remove +gtk_list_store_insert +gtk_list_store_insert_before +gtk_list_store_insert_after +gtk_list_store_prepend +gtk_list_store_append +<SUBSECTION Standard> +GTK_LIST_STORE +GTK_IS_LIST_STORE +GTK_TYPE_LIST_STORE +gtk_list_store_get_type +GTK_LIST_STORE_CLASS +GTK_IS_LIST_STORE_CLASS +</SECTION> + +<SECTION> <FILE>gtkvbbox</FILE> <TITLE>GtkVButtonBox</TITLE> GtkVButtonBox diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml index 265a3990e8..271b9a5a32 100644 --- a/docs/reference/gtk/tmpl/gtk-unused.sgml +++ b/docs/reference/gtk/tmpl/gtk-unused.sgml @@ -109,6 +109,14 @@ void marshal_INT__POINTER_POINTER_INT_INT(GtkObject* object, </para> +<!-- ##### SIGNAL GtkTextView::insert ##### --> +<para> + +</para> + +@textview: the object which received the signal. +@arg1: + <!-- ##### MACRO gtk_widget_set_default_visual ##### --> <para> @@ -1177,6 +1185,38 @@ really an implementation detail).</para></listitem> </para> +<!-- ##### STRUCT GtkTreeViewPrivate ##### --> +<para> + +</para> + +@model: +@flags: +@tree: +@tab_offset: +@button_pressed_node: +@button_pressed_tree: +@children: +@width: +@height: +@hadjustment: +@vadjustment: +@bin_window: +@header_window: +@anchor: +@cursor: +@cursor_drag: +@xor_gc: +@drag_pos: +@x_drag: +@prelight_node: +@prelight_tree: +@prelight_offset: +@selection: +@columns: +@column: +@header_height: + <!-- ##### MACRO GTK_WIDGET_RESIZE_NEEDED ##### --> <para> @@ -1647,6 +1687,15 @@ object. </para> +<!-- ##### SIGNAL GtkTextView::delete ##### --> +<para> + +</para> + +@textview: the object which received the signal. +@arg1: +@arg2: + <!-- ##### FUNCTION gtk_container_register_toplevel ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml new file mode 100644 index 0000000000..b94a574895 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml @@ -0,0 +1,76 @@ +<!-- ##### SECTION Title ##### --> +GtkCellRenderer + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### ENUM GtkCellRendererType ##### --> +<para> + +</para> + +@GTK_CELL_RENDERER_SELECTED: +@GTK_CELL_RENDERER_PRELIT: +@GTK_CELL_RENDERER_INSENSITIVE: + +<!-- ##### STRUCT GtkCellRenderer ##### --> +<para> + +</para> + +@parent: +@xalign: +@yalign: +@xpad: +@ypad: + +<!-- ##### FUNCTION gtk_cell_renderer_get_size ##### --> +<para> + +</para> + +@cell: +@widget: +@width: +@height: + + +<!-- ##### FUNCTION gtk_cell_renderer_render ##### --> +<para> + +</para> + +@cell: +@window: +@widget: +@background_area: +@cell_area: +@expose_area: +@flags: + + +<!-- ##### FUNCTION gtk_cell_renderer_event ##### --> +<para> + +</para> + +@cell: +@event: +@widget: +@path: +@background_area: +@cell_area: +@flags: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml new file mode 100644 index 0000000000..422b384bd8 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml @@ -0,0 +1,32 @@ +<!-- ##### SECTION Title ##### --> +GtkCellRendererPixbuf + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkCellRendererPixbuf ##### --> +<para> + +</para> + +@parent: +@pixbuf: + +<!-- ##### FUNCTION gtk_cell_renderer_pixbuf_new ##### --> +<para> + +</para> + +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml new file mode 100644 index 0000000000..8016b47878 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml @@ -0,0 +1,31 @@ +<!-- ##### SECTION Title ##### --> +GtkCellRendererText + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkCellRendererText ##### --> +<para> + +</para> + +@parent: + +<!-- ##### FUNCTION gtk_cell_renderer_text_new ##### --> +<para> + +</para> + +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertextpixbuf.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertextpixbuf.sgml new file mode 100644 index 0000000000..1b6cf94862 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkcellrenderertextpixbuf.sgml @@ -0,0 +1,31 @@ +<!-- ##### SECTION Title ##### --> +GtkCellRendererTextPixbuf + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkCellRendererTextPixbuf ##### --> +<para> + +</para> + +@parent: + +<!-- ##### FUNCTION gtk_cell_renderer_text_pixbuf_new ##### --> +<para> + +</para> + +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml new file mode 100644 index 0000000000..96dc1bb05d --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml @@ -0,0 +1,40 @@ +<!-- ##### SECTION Title ##### --> +GtkCellRendererToggle + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkCellRendererToggle ##### --> +<para> + +</para> + +@parent: + +<!-- ##### FUNCTION gtk_cell_renderer_toggle_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_cell_renderer_toggle_set_radio ##### --> +<para> + +</para> + +@toggle: +@radio: + + diff --git a/docs/reference/gtk/tmpl/gtkclipboard.sgml b/docs/reference/gtk/tmpl/gtkclipboard.sgml index 3aa4d27fc2..1fcefb4b6c 100644 --- a/docs/reference/gtk/tmpl/gtkclipboard.sgml +++ b/docs/reference/gtk/tmpl/gtkclipboard.sgml @@ -250,8 +250,7 @@ will not be used again. </para> @clipboard: -@Returns: -<!-- +@Returns: <!-- Local variables: mode: sgml sgml-parent-document: ("../gtk-docs.sgml" "book" "refsect2" "") diff --git a/docs/reference/gtk/tmpl/gtkliststore.sgml b/docs/reference/gtk/tmpl/gtkliststore.sgml new file mode 100644 index 0000000000..e699ba365b --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkliststore.sgml @@ -0,0 +1,128 @@ +<!-- ##### SECTION Title ##### --> +GtkListStore + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkListStore ##### --> +<para> + +</para> + +@parent: + +<!-- ##### FUNCTION gtk_list_store_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_list_store_new_with_types ##### --> +<para> + +</para> + +@n_columns: +@Varargs: +@Returns: + + +<!-- ##### FUNCTION gtk_list_store_set_n_columns ##### --> +<para> + +</para> + +@store: +@n_columns: + + +<!-- ##### FUNCTION gtk_list_store_set_column_type ##### --> +<para> + +</para> + +@store: +@column: +@type: + + +<!-- ##### FUNCTION gtk_list_store_set_cell ##### --> +<para> + +</para> + +@store: +@iter: +@column: +@value: + + +<!-- ##### FUNCTION gtk_list_store_remove ##### --> +<para> + +</para> + +@store: +@iter: + + +<!-- ##### FUNCTION gtk_list_store_insert ##### --> +<para> + +</para> + +@store: +@iter: +@position: + + +<!-- ##### FUNCTION gtk_list_store_insert_before ##### --> +<para> + +</para> + +@store: +@iter: +@sibling: + + +<!-- ##### FUNCTION gtk_list_store_insert_after ##### --> +<para> + +</para> + +@store: +@iter: +@sibling: + + +<!-- ##### FUNCTION gtk_list_store_prepend ##### --> +<para> + +</para> + +@store: +@iter: + + +<!-- ##### FUNCTION gtk_list_store_append ##### --> +<para> + +</para> + +@store: +@iter: + + diff --git a/docs/reference/gtk/tmpl/gtkmodelsimple.sgml b/docs/reference/gtk/tmpl/gtkmodelsimple.sgml new file mode 100644 index 0000000000..110f8b98fd --- /dev/null +++ b/docs/reference/gtk/tmpl/gtkmodelsimple.sgml @@ -0,0 +1,64 @@ +<!-- ##### SECTION Title ##### --> +GtkModelSimple + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### FUNCTION gtk_model_simple_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_model_simple_node_changed ##### --> +<para> + +</para> + +@simple: +@path: +@iter: + + +<!-- ##### FUNCTION gtk_model_simple_node_inserted ##### --> +<para> + +</para> + +@simple: +@path: +@iter: + + +<!-- ##### FUNCTION gtk_model_simple_node_child_toggled ##### --> +<para> + +</para> + +@simple: +@path: +@iter: + + +<!-- ##### FUNCTION gtk_model_simple_node_deleted ##### --> +<para> + +</para> + +@simple: +@path: +@iter: + + diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml index 98beda762b..82ce9d1ec0 100644 --- a/docs/reference/gtk/tmpl/gtktextview.sgml +++ b/docs/reference/gtk/tmpl/gtktextview.sgml @@ -178,7 +178,7 @@ types related to the text widget and how they work together. @textview: the object which received the signal. -<!-- ##### SIGNAL GtkTextView::delete ##### --> +<!-- ##### SIGNAL GtkTextView::delete-at-cursor ##### --> <para> </para> @@ -187,7 +187,7 @@ types related to the text widget and how they work together. @arg1: @arg2: -<!-- ##### SIGNAL GtkTextView::insert ##### --> +<!-- ##### SIGNAL GtkTextView::insert-at-cursor ##### --> <para> </para> diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml new file mode 100644 index 0000000000..43f66c0a50 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml @@ -0,0 +1,312 @@ +<!-- ##### SECTION Title ##### --> +gtktreemodel + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### MACRO GTK_TREE_MODEL_GET_IFACE ##### --> +<para> + +</para> + +@obj: + + +<!-- ##### STRUCT GtkTreeIter ##### --> +<para> + +</para> + +@stamp: +@tree_node: + +<!-- ##### STRUCT GtkTreePath ##### --> +<para> + +</para> + + +<!-- ##### STRUCT GtkTreeModel ##### --> +<para> + +</para> + + +<!-- ##### STRUCT GtkTreeModelIface ##### --> +<para> + +</para> + +@g_iface: +@changed: +@inserted: +@child_toggled: +@deleted: +@get_n_columns: +@get_column_type: +@get_iter: +@get_path: +@get_value: +@iter_next: +@iter_children: +@iter_has_child: +@iter_n_children: +@iter_nth_child: +@iter_parent: + +<!-- ##### FUNCTION gtk_tree_path_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_new_from_string ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_to_string ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_new_root ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_append_index ##### --> +<para> + +</para> + +@path: +@index: + + +<!-- ##### FUNCTION gtk_tree_path_prepend_index ##### --> +<para> + +</para> + +@path: +@index: + + +<!-- ##### FUNCTION gtk_tree_path_get_depth ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_get_indices ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_free ##### --> +<para> + +</para> + +@path: + + +<!-- ##### FUNCTION gtk_tree_path_copy ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_compare ##### --> +<para> + +</para> + +@a: +@b: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_next ##### --> +<para> + +</para> + +@path: + + +<!-- ##### FUNCTION gtk_tree_path_prev ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_up ##### --> +<para> + +</para> + +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_path_down ##### --> +<para> + +</para> + +@path: + + +<!-- ##### FUNCTION gtk_tree_model_get_n_columns ##### --> +<para> + +</para> + +@tree_model: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_get_column_type ##### --> +<para> + +</para> + +@tree_model: +@index: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_get_iter ##### --> +<para> + +</para> + +@tree_model: +@iter: +@path: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_get_path ##### --> +<para> + +</para> + +@tree_model: +@iter: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_get_value ##### --> +<para> + +</para> + +@tree_model: +@iter: +@column: +@value: + + +<!-- ##### FUNCTION gtk_tree_model_iter_next ##### --> +<para> + +</para> + +@tree_model: +@iter: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_iter_children ##### --> +<para> + +</para> + +@tree_model: +@iter: +@parent: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_iter_has_child ##### --> +<para> + +</para> + +@tree_model: +@iter: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_iter_n_children ##### --> +<para> + +</para> + +@tree_model: +@iter: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_iter_nth_child ##### --> +<para> + +</para> + +@tree_model: +@iter: +@parent: +@n: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_model_iter_parent ##### --> +<para> + +</para> + +@tree_model: +@iter: +@child: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtktreeselection.sgml b/docs/reference/gtk/tmpl/gtktreeselection.sgml new file mode 100644 index 0000000000..b3d566d5b2 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtktreeselection.sgml @@ -0,0 +1,182 @@ +<!-- ##### SECTION Title ##### --> +GtkTreeSelection + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### ENUM GtkTreeSelectionType ##### --> +<para> + +</para> + +@GTK_TREE_SELECTION_SINGLE: +@GTK_TREE_SELECTION_MULTI: + +<!-- ##### USER_FUNCTION GtkTreeSelectionFunc ##### --> +<para> + +</para> + +@selection: +@model: +@path: +@data: +@Returns: + + +<!-- ##### USER_FUNCTION GtkTreeSelectionForeachFunc ##### --> +<para> + +</para> + +@model: +@iter: +@data: + + +<!-- ##### FUNCTION gtk_tree_selection_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_tree_selection_set_type ##### --> +<para> + +</para> + +@selection: +@type: + + +<!-- ##### FUNCTION gtk_tree_selection_set_select_function ##### --> +<para> + +</para> + +@selection: +@func: +@data: + + +<!-- ##### FUNCTION gtk_tree_selection_get_user_data ##### --> +<para> + +</para> + +@selection: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_selection_get_selected ##### --> +<para> + +</para> + +@selection: +@iter: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_selection_selected_foreach ##### --> +<para> + +</para> + +@selection: +@func: +@data: + + +<!-- ##### FUNCTION gtk_tree_selection_select_path ##### --> +<para> + +</para> + +@selection: +@path: + + +<!-- ##### FUNCTION gtk_tree_selection_unselect_path ##### --> +<para> + +</para> + +@selection: +@path: + + +<!-- ##### FUNCTION gtk_tree_selection_select_iter ##### --> +<para> + +</para> + +@selection: +@iter: + + +<!-- ##### FUNCTION gtk_tree_selection_unselect_iter ##### --> +<para> + +</para> + +@selection: +@iter: + + +<!-- ##### FUNCTION gtk_tree_selection_select_all ##### --> +<para> + +</para> + +@selection: + + +<!-- ##### FUNCTION gtk_tree_selection_unselect_all ##### --> +<para> + +</para> + +@selection: + + +<!-- ##### FUNCTION gtk_tree_selection_select_range ##### --> +<para> + +</para> + +@selection: +@start_path: +@end_path: + + +<!-- ##### FUNCTION gtk_tree_selection_new_with_tree_view ##### --> +<para> + +</para> + +@tree_view: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_selection_set_tree_view ##### --> +<para> + +</para> + +@selection: +@tree_view: + + diff --git a/docs/reference/gtk/tmpl/gtktreestore.sgml b/docs/reference/gtk/tmpl/gtktreestore.sgml new file mode 100644 index 0000000000..d5171103b7 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtktreestore.sgml @@ -0,0 +1,208 @@ +<!-- ##### SECTION Title ##### --> +GtkTreeStore + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkTreeStore ##### --> +<para> + +</para> + +@parent: +@stamp: +@root: +@last: +@n_columns: +@column_headers: + +<!-- ##### FUNCTION gtk_tree_store_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_tree_store_new_with_values ##### --> +<para> + +</para> + +@n_columns: +@Varargs: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_store_set_n_columns ##### --> +<para> + +</para> + +@tree_store: +@n_columns: + + +<!-- ##### FUNCTION gtk_tree_store_set_column_type ##### --> +<para> + +</para> + +@store: +@column: +@type: + + +<!-- ##### FUNCTION gtk_tree_store_set_cell ##### --> +<para> + +</para> + +@tree_store: +@iter: +@column: +@value: + + +<!-- ##### FUNCTION gtk_tree_store_set ##### --> +<para> + +</para> + +@tree_store: +@iter: +@Varargs: + + +<!-- ##### FUNCTION gtk_tree_store_setv ##### --> +<para> + +</para> + +@tree_store: +@iter: +@var_args: + + +<!-- ##### FUNCTION gtk_tree_store_get ##### --> +<para> + +</para> + +@tree_store: +@iter: +@Varargs: + + +<!-- ##### FUNCTION gtk_tree_store_getv ##### --> +<para> + +</para> + +@tree_store: +@iter: +@var_args: + + +<!-- ##### FUNCTION gtk_tree_store_remove ##### --> +<para> + +</para> + +@tree_store: +@iter: + + +<!-- ##### FUNCTION gtk_tree_store_insert ##### --> +<para> + +</para> + +@tree_store: +@iter: +@parent: +@position: + + +<!-- ##### FUNCTION gtk_tree_store_insert_before ##### --> +<para> + +</para> + +@tree_store: +@iter: +@parent: +@sibling: + + +<!-- ##### FUNCTION gtk_tree_store_insert_after ##### --> +<para> + +</para> + +@tree_store: +@iter: +@parent: +@sibling: + + +<!-- ##### FUNCTION gtk_tree_store_prepend ##### --> +<para> + +</para> + +@tree_store: +@iter: +@parent: + + +<!-- ##### FUNCTION gtk_tree_store_append ##### --> +<para> + +</para> + +@tree_store: +@iter: +@parent: + + +<!-- ##### FUNCTION gtk_tree_store_get_root_iter ##### --> +<para> + +</para> + +@tree_store: +@iter: + + +<!-- ##### FUNCTION gtk_tree_store_is_ancestor ##### --> +<para> + +</para> + +@tree_store: +@iter: +@descendant: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_store_iter_depth ##### --> +<para> + +</para> + +@tree_store: +@iter: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml new file mode 100644 index 0000000000..bff0f90aa0 --- /dev/null +++ b/docs/reference/gtk/tmpl/gtktreeview.sgml @@ -0,0 +1,270 @@ +<!-- ##### SECTION Title ##### --> +GtkTreeView + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### STRUCT GtkTreeView ##### --> +<para> + +</para> + +@parent: +@priv: + +<!-- ##### STRUCT GtkTreeSelection ##### --> +<para> + +</para> + +@parent: +@tree_view: +@type: +@user_func: +@user_data: + +<!-- ##### STRUCT GtkTreeSelectionClass ##### --> +<para> + +</para> + + +<!-- ##### FUNCTION gtk_tree_view_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_new_with_model ##### --> +<para> + +</para> + +@model: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_get_model ##### --> +<para> + +</para> + +@tree_view: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_set_model ##### --> +<para> + +</para> + +@tree_view: +@model: +<!-- # Unused Parameters # --> +@tree_model: + + +<!-- ##### FUNCTION gtk_tree_view_get_selection ##### --> +<para> + +</para> + +@tree_view: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_get_hadjustment ##### --> +<para> + +</para> + +@tree_view: +@Returns: +<!-- # Unused Parameters # --> +@layout: + + +<!-- ##### FUNCTION gtk_tree_view_set_hadjustment ##### --> +<para> + +</para> + +@tree_view: +@adjustment: +<!-- # Unused Parameters # --> +@layout: + + +<!-- ##### FUNCTION gtk_tree_view_get_vadjustment ##### --> +<para> + +</para> + +@tree_view: +@Returns: +<!-- # Unused Parameters # --> +@layout: + + +<!-- ##### FUNCTION gtk_tree_view_set_vadjustment ##### --> +<para> + +</para> + +@tree_view: +@adjustment: +<!-- # Unused Parameters # --> +@layout: + + +<!-- ##### FUNCTION gtk_tree_view_get_headers_visible ##### --> +<para> + +</para> + +@tree_view: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_set_headers_visible ##### --> +<para> + +</para> + +@tree_view: +@headers_visible: + + +<!-- ##### FUNCTION gtk_tree_view_columns_autosize ##### --> +<para> + +</para> + +@tree_view: + + +<!-- ##### FUNCTION gtk_tree_view_set_headers_active ##### --> +<para> + +</para> + +@tree_view: +@active: + + +<!-- ##### FUNCTION gtk_tree_view_append_column ##### --> +<para> + +</para> + +@tree_view: +@column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_remove_column ##### --> +<para> + +</para> + +@tree_view: +@column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_insert_column ##### --> +<para> + +</para> + +@tree_view: +@column: +@position: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_get_column ##### --> +<para> + +</para> + +@tree_view: +@n: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_move_to ##### --> +<para> + +</para> + +@tree_view: +@path: +@column: +@row_align: +@col_align: + + +<!-- ##### FUNCTION gtk_tree_view_get_path_at_pos ##### --> +<para> + +</para> + +@tree_view: +@window: +@x: +@y: +@path: +@column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_expand_all ##### --> +<para> + +</para> + +@tree_view: + + +<!-- ##### FUNCTION gtk_tree_view_collapse_all ##### --> +<para> + +</para> + +@tree_view: + + +<!-- ##### FUNCTION gtk_tree_view_expand_row ##### --> +<para> + +</para> + +@tree_view: +@path: +@open_all: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_collapse_row ##### --> +<para> + +</para> + +@tree_view: +@path: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml new file mode 100644 index 0000000000..67a0f6280c --- /dev/null +++ b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml @@ -0,0 +1,280 @@ +<!-- ##### SECTION Title ##### --> +GtkTreeViewColumn + +<!-- ##### SECTION Short_Description ##### --> + + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### MACRO GTK_TYPE_TREE_COLUMN ##### --> +<para> + +</para> + + + +<!-- ##### STRUCT GtkTreeViewColumn ##### --> +<para> + +</para> + +@parent: +@tree_view: +@button: +@window: +@justification: +@id: +@size: +@min_width: +@max_width: +@func: +@func_data: +@title: +@cell: +@attributes: +@column_type: +@visible: +@button_active: +@dirty: + +<!-- ##### ENUM GtkTreeViewColumnType ##### --> +<para> + +</para> + +@GTK_TREE_VIEW_COLUMN_RESIZEABLE: +@GTK_TREE_VIEW_COLUMN_AUTOSIZE: +@GTK_TREE_VIEW_COLUMN_FIXED: + +<!-- ##### USER_FUNCTION GtkTreeViewColumnFunc ##### --> +<para> + +</para> + +@tree_column: +@tree_model: +@iter: +@data: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_new_with_attributes ##### --> +<para> + +</para> + +@title: +@cell: +@Varargs: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_cell_renderer ##### --> +<para> + +</para> + +@tree_column: +@cell: + + +<!-- ##### FUNCTION gtk_tree_view_column_add_attribute ##### --> +<para> + +</para> + +@tree_column: +@attribute: +@column: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_attributes ##### --> +<para> + +</para> + +@tree_column: +@Varargs: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_cell_data ##### --> +<para> + +</para> + +@tree_column: +@tree_model: +@iter: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_visible ##### --> +<para> + +</para> + +@tree_column: +@visible: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_visible ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_col_type ##### --> +<para> + +</para> + +@tree_column: +@type: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_col_type ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_size ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_size ##### --> +<para> + +</para> + +@tree_column: +@size: +<!-- # Unused Parameters # --> +@width: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_min_width ##### --> +<para> + +</para> + +@tree_column: +@min_width: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_min_width ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_max_width ##### --> +<para> + +</para> + +@tree_column: +@max_width: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_max_width ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_title ##### --> +<para> + +</para> + +@tree_column: +@title: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_title ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_header_active ##### --> +<para> + +</para> + +@tree_column: +@active: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_widget ##### --> +<para> + +</para> + +@tree_column: +@widget: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_widget ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + +<!-- ##### FUNCTION gtk_tree_view_column_set_justification ##### --> +<para> + +</para> + +@tree_column: +@justification: + + +<!-- ##### FUNCTION gtk_tree_view_column_get_justification ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + diff --git a/docs/reference/gtk/tree_widget.sgml b/docs/reference/gtk/tree_widget.sgml new file mode 100644 index 0000000000..7efe6491f5 --- /dev/null +++ b/docs/reference/gtk/tree_widget.sgml @@ -0,0 +1,74 @@ +<refentry id="TreeWidget" revision="30 Oct 2000"> + <refmeta> + <refentrytitle>Tree and List Widget Overview</refentrytitle> + <manvolnum>3</manvolnum> + <refmiscinfo>GTK Library</refmiscinfo> + </refmeta> + + <refnamediv> + <refname>Tree and List Widget Overview</refname> + <refpurpose>Overview of <link linkend="GtkTreeModel">GtkTreeModel</link>, <link linkend="GtkTreeView">GtkTreeView</link>, and friends</refpurpose> + </refnamediv> + + <refsect1> + <title>Overview</title> + <para> + To create a tree or list in GTK+, you need to use the <link + linkend="GtkTreeModel">GtkTreeModel</link> interface, in + conjunction with the <link + linkend="GtkTreeView">GtkTreeView</link>. + </para> + <para> + <emphasis>Write real docs here</emphasis> + </para> + </refsect1> + + + <refsect1> + <title>Simple Example</title> + <para> + Here is a simple example of using a <link + linkend="GtkTreeView">GtkTreeView</link> widget in context of the + other widgets. It simply creates a simple model and view, and + puts them together. Note that the model is never populated with + data — that is left as an exercise for the reader. + <programlisting><![CDATA[ +{ + GtkTreeStore *model; + GtkWidget *view; + GtkTreeViewColumn *column; + GtkCellRenderer *cell_renderer; + + /* Create a model. We are using the store model for now, though we + * could use any other GtkTreeModel */ + model = gtk_tree_store_new_with_values (1, G_TYPE_STRING); + + /* Create a view */ + view = gtk_tree_view_new_with_model (GTK_TREE_MODEL (model)); + + /* The view now holds a reference. We can get rid of our own + * reference */ + g_object_unref (G_OBJECT (model)); + + /* Create a cell render and set an attribute */ + cell_renderer = gtk_cell_renderer_text_new (); + g_object_set (G_OBJECT (cell_renderer), + "foreground", "red", + NULL); + + /* Create a column, associating the "text" attribute of the + * cell_renderer to the first column of the model */ + column = gtk_tree_view_column_new_with_attributes ("title", + cell_renderer, + "text", 0, + NULL); + + /* Add the column to the view. */ + gtk_tree_view_append_column (GTK_TREE_VIEW (view), column); +} +]]> + </programlisting> + </para> + </refsect1> + +</refentry> |