gtktree.html

该压缩包包含了GTK+的大量API函数

BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_prepend                (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *tree_item);</PRE
></TD
></TR
></TABLE
><P
>Adds the <A
HREF="gtktreeitem.html"
>GtkTreeItem</A
> in <TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
> to the start of the items in <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43052"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the <A
HREF="gtkwidget.html"
>GtkWidget</A
> that is to be prepended to the tree.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43067"
></A
><H3
><A
NAME="GTK-TREE-INSERT"
></A
>gtk_tree_insert ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_insert                 (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *tree_item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> position);</PRE
></TD
></TR
></TABLE
><P
>Adds the <A
HREF="gtktreeitem.html"
>GtkTreeItem</A
> in <TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
> to the list of items in <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
> at the position indicated by <TT
CLASS="PARAMETER"
><I
>position</I
></TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43079"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the <A
HREF="gtkwidget.html"
>GtkWidget</A
> that is to be added to the tree.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> that indicates the position in the tree, that the tree_item is to be added at.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43099"
></A
><H3
><A
NAME="GTK-TREE-REMOVE-ITEMS"
></A
>gtk_tree_remove_items ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_remove_items           (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A> *items);</PRE
></TD
></TR
></TABLE
><P
>Removes a list of items from the <A
HREF="gtktree.html"
>GtkTree</A
> in <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>.</P
><P
>If only one item is to be removed from the <A
HREF="gtktree.html"
>GtkTree</A
>, <A
HREF="gtkcontainer.html#GTK-CONTAINER-REMOVE"
>gtk_container_remove</A
>() can be used instead.</P
><P
>Removing an item from a <A
HREF="gtktree.html"
>GtkTree</A
> dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use <A
HREF="gtkobject.html#GTK-OBJECT-REF"
>gtk_object_ref</A
>() before removing it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43114"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>items</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A> that contains the items to be removed.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43129"
></A
><H3
><A
NAME="GTK-TREE-CLEAR-ITEMS"
></A
>gtk_tree_clear_items ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_clear_items            (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> start,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> end);</PRE
></TD
></TR
></TABLE
><P
>Removes the items at positions between <TT
CLASS="PARAMETER"
><I
>start</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>end</I
></TT
> from the <A
HREF="gtktree.html"
>GtkTree</A
> <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>.</P
><P
>Removing an item from a <A
HREF="gtktree.html"
>GtkTree</A
> dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use <A
HREF="gtkobject.html#GTK-OBJECT-REF"
>gtk_object_ref</A
>() before removing it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43144"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A gint.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>end</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A gint.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43162"
></A
><H3
><A
NAME="GTK-TREE-SELECT-ITEM"
></A
>gtk_tree_select_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_select_item            (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> item);</PRE
></TD
></TR
></TABLE
><P
>Emits the select_item signal for the child at position <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>, and thus selects it (unless it is unselected in a signal handler).</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43171"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A gint.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43185"
></A
><H3
><A
NAME="GTK-TREE-UNSELECT-ITEM"
></A
>gtk_tree_unselect_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_unselect_item          (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> item);</PRE
></TD
></TR
></TABLE
><P
>Emits the unselect_item for the child at position <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>, and thus unselects it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43194"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A gint.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43208"
></A
><H3
><A
NAME="GTK-TREE-SELECT-CHILD"
></A
>gtk_tree_select_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_select_child           (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *tree_item);</PRE
></TD
></TR
></TABLE
><P
>Emits the select_item signal for the child <TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
>, and thus selects it (unless it is unselected in a signal handler).</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43217"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the <A
HREF="gtkwidget.html"
>GtkWidget</A
> that is to be selected.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43232"
></A
><H3
><A
NAME="GTK-TREE-UNSELECT-CHILD"
></A
>gtk_tree_unselect_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_unselect_child         (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *tree_item);</PRE
></TD
></TR
></TABLE
><P
>Emits the unselect_item signal for the child <TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
>, and thus unselects it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43241"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the <A
HREF="gtkwidget.html"
>GtkWidget</A
> that is to be selected.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43256"
></A
><H3
><A
NAME="GTK-TREE-CHILD-POSITION"
></A
>gtk_tree_child_position ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gtk_tree_child_position         (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *child);</PRE
></TD
></TR
></TABLE
><P
>Returns the position of <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> in the <A
HREF="gtktree.html"
>GtkTree</A
> <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>.</P
><P
>If <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> is not a child of <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>, then -1 is returned.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43270"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtktree.html"
>GtkTree</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT