gtktree.html

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

>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <A
HREF="gtkwidget.html"
>GtkWidget</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</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="AEN43289"
></A
><H3
><A
NAME="GTK-TREE-SET-SELECTION-MODE"
></A
>gtk_tree_set_selection_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_set_selection_mode     (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtk-standard-enumerations.html#GTKSELECTIONMODE"
>GtkSelectionMode</A
> mode);</PRE
></TD
></TR
></TABLE
><P
>Sets the selection mode for the <A
HREF="gtktree.html"
>GtkTree</A
> <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>.</P
><P
><TT
CLASS="PARAMETER"
><I
>mode</I
></TT
> can be one of</P
><P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>GTK_SELECTION_SINGLE</TT
> for when only one item can be selected at a time.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GTK_SELECTION_BROWSE</TT
> for when one item must be selected.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GTK_SELECTION_MULTIPLE</TT
> for when many items can be selected at once.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GTK_SELECTION_EXTENDED</TT
> Reserved for later use.</P
></LI
></UL
><P
>The selection mode is only defined for a root tree, as the root tree "owns" the selection.</P
><P
>The default mode is <TT
CLASS="LITERAL"
>GTK_SELECTION_SINGLE</TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43316"
></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
>mode</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A <A
HREF="gtk-standard-enumerations.html#GTKSELECTIONMODE"
>GtkSelectionMode</A
>.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43331"
></A
><H3
><A
NAME="GTK-TREE-SET-VIEW-MODE"
></A
>gtk_tree_set_view_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_set_view_mode          (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtktree.html#GTKTREEVIEWMODE"
>GtkTreeViewMode</A
> mode);</PRE
></TD
></TR
></TABLE
><P
>Sets the 'viewmode' for the <A
HREF="gtktree.html"
>GtkTree</A
> in <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>. The 'viewmode' defines how the tree looks when an item is selected.</P
><P
><TT
CLASS="PARAMETER"
><I
>mode</I
></TT
> can be one of:</P
><P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>GTK_TREE_VIEW_LINE</TT
> : When an item is selected the entire <A
HREF="gtktreeitem.html"
>GtkTreeItem</A
> is highlighted.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GTK_TREE_VIEW_ITEM</TT
> : When an item is selected only the selected item's child widget is highlighted.</P
></LI
></UL
><P
>The default mode is <TT
CLASS="LITERAL"
>GTK_TREE_VIEW_LINE</TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43352"
></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
>mode</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A <A
HREF="gtktree.html#GTKTREEVIEWMODE"
>GtkTreeViewMode</A
>.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43367"
></A
><H3
><A
NAME="GTK-TREE-SET-VIEW-LINES"
></A
>gtk_tree_set_view_lines ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_set_view_lines         (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> flag);</PRE
></TD
></TR
></TABLE
><P
>Sets whether or not the connecting lines between branches and children are drawn.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43374"
></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
>flag</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A guint, indicating <TT
CLASS="LITERAL"
>TRUE</TT
>, or <TT
CLASS="LITERAL"
>FALSE</TT
>.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43390"
></A
><H3
><A
NAME="GTK-TREE-REMOVE-ITEM"
></A
>gtk_tree_remove_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_tree_remove_item            (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                             <A
HREF="gtkwidget.html"
>GtkWidget</A
> *child);</PRE
></TD
></TR
></TABLE
><P
>Removes the item <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> from the <A
HREF="gtktree.html"
>GtkTree</A
> <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43400"
></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
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the <A
HREF="gtkwidget.html"
>GtkWidget</A
> that is to be removed from the tree.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN43415"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN43417"
></A
><H3
><A
NAME="GTKTREE-SELECTION-CHANGED"
></A
>The &quot;selection-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted by the root tree whenever the selection changes.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43424"
></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"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43437"
></A
><H3
><A
NAME="GTKTREE-SELECT-CHILD"
></A
>The &quot;select-child&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                            <A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted by <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
> whenever <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> is about to be selected.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43447"
></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"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The child that is about to be selected.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN43464"
></A
><H3
><A
NAME="GTKTREE-UNSELECT-CHILD"
></A
>The &quot;unselect-child&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gtktree.html"
>GtkTree</A
> *tree,
                                            <A
HREF="gtkwidget.html"
>GtkWidget</A
> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted by <TT
CLASS="PARAMETER"
><I
>tree</I
></TT
> whenever <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> is about to be unselected.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN43474"
></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"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The child that is about to be unselected.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN43491"
></A
><H2
>See Also</H2
><P
>GtkTreeList for the items to put into a <A
HREF="gtktree.html"
>GtkTree</A
>.</P
><P
><A
HREF="gtkscrolledwindow.html"
>GtkScrolledWindow</A
> for details on how to scroll around a <A
HREF="gtktree.html"
>GtkTree</A
>.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtktooltips.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="index.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gtkobjects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtktreeitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkTooltips</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkTreeItem</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>