sec-treewidgetinternals.html

来自「gtk的教材和问答集」· HTML 代码 · 共 859 行 · 第 1/2 页

WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_prepend( GtkTree   *tree,
                       GtkWidget *tree_item );</PRE
></TD
></TR
></TABLE
><P
>Prepend a tree item to a Tree.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_insert( GtkTree   *tree,
                      GtkWidget *tree_item,
                      gint       position );</PRE
></TD
></TR
></TABLE
><P
>Insert a tree item into a Tree at the position in the list
specified by <TT
CLASS="LITERAL"
>position.</TT
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_remove_items( GtkTree *tree,
                            GList   *items );</PRE
></TD
></TR
></TABLE
><P
>Remove a list of items (in the form of a GList *) from a Tree.
Note that removing an item from a tree dereferences (and thus usually)
destroys it <I
CLASS="EMPHASIS"
>and</I
> its subtree, if it has one, <I
CLASS="EMPHASIS"
>and</I
> all
subtrees in that subtree. If you want to remove only one item, you
can use gtk_container_remove().</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_clear_items( GtkTree *tree,
                           gint     start,
                           gint     end );</PRE
></TD
></TR
></TABLE
><P
>Remove the items from position <TT
CLASS="LITERAL"
>start</TT
> to position <TT
CLASS="LITERAL"
>end</TT
>
from a Tree. The same warning about dereferencing applies here, as
gtk_tree_clear_items() simply constructs a list and passes it to
gtk_tree_remove_items().</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_select_item( GtkTree *tree,
                           gint     item );</PRE
></TD
></TR
></TABLE
><P
>Emits the "select_item" signal for the child at position
<TT
CLASS="LITERAL"
>item</TT
>, thus selecting the child (unless you unselect it in a
signal handler).</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_unselect_item( GtkTree *tree,
                             gint     item );</PRE
></TD
></TR
></TABLE
><P
>Emits the "unselect_item" signal for the child at position
<TT
CLASS="LITERAL"
>item</TT
>, thus unselecting the child.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_select_child( GtkTree   *tree,
                            GtkWidget *tree_item );</PRE
></TD
></TR
></TABLE
><P
>Emits the "select_item" signal for the child <TT
CLASS="LITERAL"
>tree_item</TT
>, thus
selecting it.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_unselect_child( GtkTree   *tree,
                              GtkWidget *tree_item );</PRE
></TD
></TR
></TABLE
><P
>Emits the "unselect_item" signal for the child <TT
CLASS="LITERAL"
>tree_item</TT
>,
thus unselecting it.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>gint gtk_tree_child_position( GtkTree   *tree,
                              GtkWidget *child );</PRE
></TD
></TR
></TABLE
><P
>Returns the position in the tree of <TT
CLASS="LITERAL"
>child</TT
>, unless
<TT
CLASS="LITERAL"
>child</TT
> is not in the tree, in which case it returns -1.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_set_selection_mode( GtkTree          *tree,
                                  GtkSelectionMode  mode );</PRE
></TD
></TR
></TABLE
><P
>Sets the selection mode, which can be one of <TT
CLASS="LITERAL"
>GTK_SELECTION_SINGLE</TT
> (the
default), <TT
CLASS="LITERAL"
>GTK_SELECTION_BROWSE</TT
>, <TT
CLASS="LITERAL"
>GTK_SELECTION_MULTIPLE</TT
>, or
<TT
CLASS="LITERAL"
>GTK_SELECTION_EXTENDED</TT
>. This is only defined for root trees, which
makes sense, since the root tree "owns" the selection. Setting it for
subtrees has no effect at all; the value is simply ignored.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_set_view_mode( GtkTree         *tree,
                             GtkTreeViewMode  mode ); </PRE
></TD
></TR
></TABLE
><P
>Sets the "view mode", which can be either <TT
CLASS="LITERAL"
>GTK_TREE_VIEW_LINE</TT
> (the
default) or <TT
CLASS="LITERAL"
>GTK_TREE_VIEW_ITEM</TT
>.  The view mode propagates from a
tree to its subtrees, and can't be set exclusively to a subtree (this
is not exactly true - see the example code comments).</P
><P
>The term "view mode" is rather ambiguous - basically, it controls the
way the highlight is drawn when one of a tree's children is selected.
If it's <TT
CLASS="LITERAL"
>GTK_TREE_VIEW_LINE</TT
>, the entire TreeItem widget is
highlighted, while for <TT
CLASS="LITERAL"
>GTK_TREE_VIEW_ITEM</TT
>, only the child widget
(i.e., usually the label) is highlighted.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gtk_tree_set_view_lines( GtkTree *tree,
                              guint    flag );</PRE
></TD
></TR
></TABLE
><P
>Controls whether connecting lines between tree items are drawn.
<TT
CLASS="LITERAL"
>flag</TT
> is either TRUE, in which case they are, or FALSE, in
which case they aren't.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkTree *GTK_TREE (gpointer obj);</PRE
></TD
></TR
></TABLE
><P
>Cast a generic pointer to "GtkTree *".</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkTreeClass *GTK_TREE_CLASS (gpointer class);</PRE
></TD
></TR
></TABLE
><P
>Cast a generic pointer to "GtkTreeClass *".</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>gint GTK_IS_TREE (gpointer obj);</PRE
></TD
></TR
></TABLE
><P
>Determine if a generic pointer refers to a "GtkTree" object.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>gint GTK_IS_ROOT_TREE (gpointer obj)</PRE
></TD
></TR
></TABLE
><P
>Determine if a generic pointer refers to a "GtkTree" object
<I
CLASS="EMPHASIS"
>and</I
> is a root tree. Though this will accept any pointer, the
results of passing it a pointer that does not refer to a Tree are
undefined and possibly harmful.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkTree *GTK_TREE_ROOT_TREE (gpointer obj)</PRE
></TD
></TR
></TABLE
><P
>Return the root tree of a pointer to a "GtkTree" object. The above
warning applies.</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GList *GTK_TREE_SELECTION( gpointer obj)</PRE
></TD
></TR
></TABLE
><P
>Return the selection list of the root tree of a "GtkTree" object. The
above warning applies here, too.</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sec-handlingtheselectionlist.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gtk-tut.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sec-treeitemwidget.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Handling the Selection List</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ch-treewidget.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Tree Item Widget</TD
></TR
></TABLE
></DIV
>    
    </td>
    </tr></table>
  </td>
  </tr>
</table>
</body>
</BODY
></HTML
>