📄 gtktree.html
字号:
<HTML><HEAD><TITLE>GtkTree</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkTooltips"HREF="gtktooltips.html"><LINKREL="NEXT"TITLE="GtkTreeItem"HREF="gtktreeitem.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtktooltips.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtktreeitem.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKTREE">GtkTree</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN42848"></A><H2>Name</H2>GtkTree -- A treelist widget.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN42851"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtktree.html#GTKTREE-STRUCT">GtkTree</A>;#define <AHREF="gtktree.html#GTK-IS-ROOT-TREE-CAPS">GTK_IS_ROOT_TREE</A> (obj)#define <AHREF="gtktree.html#GTK-TREE-ROOT-TREE-CAPS">GTK_TREE_ROOT_TREE</A> (obj)#define <AHREF="gtktree.html#GTK-TREE-SELECTION-CAPS">GTK_TREE_SELECTION</A> (obj)enum <AHREF="gtktree.html#GTKTREEVIEWMODE">GtkTreeViewMode</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktree.html#GTK-TREE-NEW">gtk_tree_new</A> (void);void <AHREF="gtktree.html#GTK-TREE-APPEND">gtk_tree_append</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *tree_item);void <AHREF="gtktree.html#GTK-TREE-PREPEND">gtk_tree_prepend</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *tree_item);void <AHREF="gtktree.html#GTK-TREE-INSERT">gtk_tree_insert</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *tree_item, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);void <AHREF="gtktree.html#GTK-TREE-REMOVE-ITEMS">gtk_tree_remove_items</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items);void <AHREF="gtktree.html#GTK-TREE-CLEAR-ITEMS">gtk_tree_clear_items</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> start, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> end);void <AHREF="gtktree.html#GTK-TREE-SELECT-ITEM">gtk_tree_select_item</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> item);void <AHREF="gtktree.html#GTK-TREE-UNSELECT-ITEM">gtk_tree_unselect_item</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> item);void <AHREF="gtktree.html#GTK-TREE-SELECT-CHILD">gtk_tree_select_child</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *tree_item);void <AHREF="gtktree.html#GTK-TREE-UNSELECT-CHILD">gtk_tree_unselect_child</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *tree_item);<AHREF=../glib/glib-basic-types.html#GINT>gint</A> <AHREF="gtktree.html#GTK-TREE-CHILD-POSITION">gtk_tree_child_position</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *child);void <AHREF="gtktree.html#GTK-TREE-SET-SELECTION-MODE">gtk_tree_set_selection_mode</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtk-standard-enumerations.html#GTKSELECTIONMODE">GtkSelectionMode</A> mode);void <AHREF="gtktree.html#GTK-TREE-SET-VIEW-MODE">gtk_tree_set_view_mode</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtktree.html#GTKTREEVIEWMODE">GtkTreeViewMode</A> mode);void <AHREF="gtktree.html#GTK-TREE-SET-VIEW-LINES">gtk_tree_set_view_lines</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> flag);void <AHREF="gtktree.html#GTK-TREE-REMOVE-ITEM">gtk_tree_remove_item</A> (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *child); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN42906"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkcontainer.html">GtkContainer</A> +----GtkTree</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN42912"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtktree.html#GTKTREE-SELECTION-CHANGED">selection-changed</A>" void user_function (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtktree.html#GTKTREE-SELECT-CHILD">select-child</A>" void user_function (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *widget, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtktree.html#GTKTREE-UNSELECT-CHILD">unselect-child</A>" void user_function (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *widget, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN42926"></A><H2>Description</H2><P>The <AHREF="gtktree.html">GtkTree</A> widget is a container that shows users a list of items, in a tree format complete with branches and leafnodes. Branches can be expanded to show their child items, or collapsed to hide them.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN42930"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN42932"></A><H3><ANAME="GTKTREE-STRUCT"></A>struct GtkTree</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkTree;</PRE></TD></TR></TABLE><P><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct _GtkTree{ GtkContainer container; GList *children; GtkTree* root_tree; /* owner of selection list */ GtkWidget* tree_owner; GList *selection; guint level; guint indent_value; guint current_indent; guint selection_mode : 2; guint view_mode : 1; guint view_line : 1;};</PRE></TD></TR></TABLE></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN42938"></A><H3><ANAME="GTK-IS-ROOT-TREE-CAPS"></A>GTK_IS_ROOT_TREE()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">#define GTK_IS_ROOT_TREE(obj) ((GtkObject*) GTK_TREE(obj)->root_tree == (GtkObject*)obj)</PRE></TD></TR></TABLE><P>A macro that returns a boolean value which indicates if <TTCLASS="PARAMETER"><I>obj</I></TT> is a root tree or not.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN42944"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>obj</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A pointer to the <AHREF="gtktree.html">GtkTree</A>. <TTCLASS="PARAMETER"><I>obj</I></TT> will accept any pointer, but if the pointer does not point to a <AHREF="gtktree.html">GtkTree</A>, the results are undefined. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN42956"></A><H3><ANAME="GTK-TREE-ROOT-TREE-CAPS"></A>GTK_TREE_ROOT_TREE()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">#define GTK_TREE_ROOT_TREE(obj) (GTK_TREE(obj)->root_tree ? GTK_TREE(obj)->root_tree : GTK_TREE(obj))</PRE></TD></TR></TABLE><P>A macro that returns the root tree of <TTCLASS="PARAMETER"><I>obj</I></TT>.</P><P>If <TTCLASS="PARAMETER"><I>obj</I></TT> is already a root tree, <TTCLASS="PARAMETER"><I>obj</I></TT> is cast to <AHREF="gtktree.html">GtkTree</A> and returned.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN42966"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>obj</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A pointer to the <AHREF="gtktree.html">GtkTree</A>. <TTCLASS="PARAMETER"><I>obj</I></TT> will accept any pointer, but if the pointer does not point to a <AHREF="gtktree.html">GtkTree</A>, the results are undefined. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN42978"></A><H3><ANAME="GTK-TREE-SELECTION-CAPS"></A>GTK_TREE_SELECTION()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">#define GTK_TREE_SELECTION(obj) (GTK_TREE_ROOT_TREE(obj)->selection)</PRE></TD></TR></TABLE><P>A macro that returns a GList that contains the selection of the root tree of <TTCLASS="PARAMETER"><I>obj</I></TT>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN42984"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>obj</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A pointer to the <AHREF="gtktree.html">GtkTree</A>. <TTCLASS="PARAMETER"><I>obj</I></TT> will accept any pointer, but it the pointer does not point to a <AHREF="gtktree.html">GtkTree</A>, the results are undefined. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN42996"></A><H3><ANAME="GTKTREEVIEWMODE"></A>enum GtkTreeViewMode</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">typedef enum { GTK_TREE_VIEW_LINE, /* default view mode */ GTK_TREE_VIEW_ITEM} GtkTreeViewMode;</PRE></TD></TR></TABLE><P></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN43001"></A><H3><ANAME="GTK-TREE-NEW"></A>gtk_tree_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_tree_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtktree.html">GtkTree</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN43008"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A pointer to the newly allocated widget. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN43017"></A><H3><ANAME="GTK-TREE-APPEND"></A>gtk_tree_append ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_tree_append (<AHREF="gtktree.html">GtkTree</A> *tree, <AHREF="gtkwidget.html">GtkWidget</A> *tree_item);</PRE></TD></TR></TABLE><P>Adds the <AHREF="gtktreeitem.html">GtkTreeItem</A> in <TTCLASS="PARAMETER"><I>tree_item</I></TT> to the end of the items in <TTCLASS="PARAMETER"><I>tree</I></TT>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN43027"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>tree</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A pointer to a <AHREF="gtktree.html">GtkTree</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>tree_item</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A pointer to the <AHREF="gtkwidget.html">GtkWidget</A> that is to be appended to the tree. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN43042"></A><H3><ANAME="GTK-TREE-PREPEND"></A>gtk_tree_prepend ()</H3><TABLE⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -