gtklist.html

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

WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.</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"
>the child to look for.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the index of the child, -1 if not found.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29951"
></A
><H3
><A
NAME="GTK-LIST-SET-SELECTION-MODE"
></A
>gtk_list_set_selection_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_set_selection_mode     (<A
HREF="gtklist.html"
>GtkList</A
> *list,
                                             <A
HREF="gtk-standard-enumerations.html#GTKSELECTIONMODE"
>GtkSelectionMode</A
> mode);</PRE
></TD
></TR
></TABLE
><P
>Set the list selection mode. The selection mode can be any value in
<A
HREF="gtk-standard-enumerations.html#GTKSELECTIONMODE"
>GtkSelectionMode</A
>:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>GTK_SELECTION_SINGLE</DT
><DD
><P
>Zero or one element may be selected.</P
></DD
><DT
>GTK_SELECTION_BROWSE</DT
><DD
><P
>Exactly one element is always selected (this can be false after you have
changed the selection mode).</P
></DD
><DT
>GTK_SELECTION_MULTIPLE</DT
><DD
><P
>Any number of elements may be selected. Clicks toggle the state of an
item.</P
></DD
><DT
>GTK_SELECTION_EXTENDED</DT
><DD
><P
>Any number of elements may be selected. Click-drag selects a range of
elements; the Ctrl key may be used to enlarge the selection, and
Shift key to select between the focus and the child pointed to.</P
></DD
></DL
></DIV
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29980"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.</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"
>the new selection mode.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29993"
></A
><H3
><A
NAME="GTK-LIST-EXTEND-SELECTION"
></A
>gtk_list_extend_selection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_extend_selection       (<A
HREF="gtklist.html"
>GtkList</A
> *list,
                                             <A
HREF="gtk-standard-enumerations.html#GTKSCROLLTYPE"
>GtkScrollType</A
> scroll_type,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> position,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> auto_start_selection);</PRE
></TD
></TR
></TABLE
><P
>Extends the selection by moving the anchor according to <TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
>. Only
in GTK_SELECTION_EXTENDED.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30004"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the direction and length.</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"
>the position if <TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
> is GTK_SCROLL_JUMP.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>auto_start_selection</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>if <A
HREF=../glib/glib-standard-macros.html#TRUE-CAPS
>TRUE</A>, gtk_list_start_selection is automatically
carried out before extending the selection.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN30028"
></A
><H3
><A
NAME="GTK-LIST-START-SELECTION"
></A
>gtk_list_start_selection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_start_selection        (<A
HREF="gtklist.html"
>GtkList</A
> *list);</PRE
></TD
></TR
></TABLE
><P
>Starts a selection (or part of selection) at the focused child. Only in
GTK_SELECTION_EXTENDED mode.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30035"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN30044"
></A
><H3
><A
NAME="GTK-LIST-END-SELECTION"
></A
>gtk_list_end_selection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_end_selection          (<A
HREF="gtklist.html"
>GtkList</A
> *list);</PRE
></TD
></TR
></TABLE
><P
>Ends the selection. Used with <A
HREF="gtklist.html#GTK-LIST-EXTEND-SELECTION"
>gtk_list_extend_selection</A
> and
<A
HREF="gtklist.html#GTK-LIST-START-SELECTION"
>gtk_list_start_selection</A
>. Only in GTK_SELECTION_EXTENDED.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30053"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN30062"
></A
><H3
><A
NAME="GTK-LIST-SELECT-ALL"
></A
>gtk_list_select_all ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_select_all             (<A
HREF="gtklist.html"
>GtkList</A
> *list);</PRE
></TD
></TR
></TABLE
><P
>Selects all children of <TT
CLASS="PARAMETER"
><I
>list</I
></TT
>. A signal will be emitted for each
newly selected child.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30069"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN30078"
></A
><H3
><A
NAME="GTK-LIST-UNSELECT-ALL"
></A
>gtk_list_unselect_all ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_unselect_all           (<A
HREF="gtklist.html"
>GtkList</A
> *list);</PRE
></TD
></TR
></TABLE
><P
>Unselects all children of <TT
CLASS="PARAMETER"
><I
>list</I
></TT
>. A signal will be emitted for each
newly unselected child.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30085"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN30094"
></A
><H3
><A
NAME="GTK-LIST-SCROLL-HORIZONTAL"
></A
>gtk_list_scroll_horizontal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_scroll_horizontal      (<A
HREF="gtklist.html"
>GtkList</A
> *list,
                                             <A
HREF="gtk-standard-enumerations.html#GTKSCROLLTYPE"
>GtkScrollType</A
> scroll_type,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> position);</PRE
></TD
></TR
></TABLE
><P
>Scrolls <TT
CLASS="PARAMETER"
><I
>list</I
></TT
> horizontaly. This supposes that the list is packed into a
scrolled window or something similar, and adjustments are well
set. Step and page increment are those from the horizontal adjustment
of <TT
CLASS="PARAMETER"
><I
>list</I
></TT
>. Backward means to the left, and forward to the
right. Out of bounds values are truncated.
<TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
> may be any valid <A
HREF="gtk-standard-enumerations.html#GTKSCROLLTYPE"
>GtkScrollType</A
>. If <TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
> is
GTK_SCROLL_NONE, nothing is done. If it's GTK_SCROLL_JUMP, the list
scrolls to the ratio <TT
CLASS="PARAMETER"
><I
>position</I
></TT
>: 0 is full left, 1 is full right.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30110"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the scrolling type.</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"
>the position if <TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
> is GTK_SCROLL_JUMP
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN30129"
></A
><H3
><A
NAME="GTK-LIST-SCROLL-VERTICAL"
></A
>gtk_list_scroll_vertical ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_list_scroll_vertical        (<A
HREF="gtklist.html"
>GtkList</A
> *list,
                                             <A
HREF="gtk-standard-enumerations.html#GTKSCROLLTYPE"
>GtkScrollType</A
> scroll_type,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> position);</PRE
></TD
></TR
></TABLE
><P
>Scrolls <TT
CLASS="PARAMETER"
><I
>list</I
></TT
> vertically. This supposes that the list is packed into a
scrolled window or something similar, and adjustments are well
set. Step and page increment are those from the vertical adjustment
of <TT
CLASS="PARAMETER"
><I
>list</I
></TT
>. Backward means up, and forward down. Out of bounds values are
truncated.
<TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
> may be any valid <A
HREF="gtk-standard-enumerations.html#GTKSCROLLTYPE"
>GtkScrollType</A
>. If <TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
> is
GTK_SCROLL_NONE, nothing is done. If it's GTK_SCROLL_JUMP, the list
scrolls to the ratio <TT
CLASS="PARAMETER"
><I
>position</I
></TT
>: 0 is top, 1 is bottom.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN30145"
></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
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the list widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>scroll_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the scrolling type.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"