📄 gtklist.html
字号:
<HTML><HEAD><TITLE>GtkList</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="GtkLayout"HREF="gtklayout.html"><LINKREL="NEXT"TITLE="GtkListItem"HREF="gtklistitem.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="gtklayout.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="gtklistitem.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKLIST">GtkList</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN29554"></A><H2>Name</H2>GtkList -- Widget for packing a list of selectable items.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN29557"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtklist.html#GTKLIST-STRUCT">GtkList</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtklist.html#GTK-LIST-NEW">gtk_list_new</A> (void);void <AHREF="gtklist.html#GTK-LIST-INSERT-ITEMS">gtk_list_insert_items</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);void <AHREF="gtklist.html#GTK-LIST-APPEND-ITEMS">gtk_list_append_items</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items);void <AHREF="gtklist.html#GTK-LIST-PREPEND-ITEMS">gtk_list_prepend_items</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items);void <AHREF="gtklist.html#GTK-LIST-REMOVE-ITEMS">gtk_list_remove_items</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items);void <AHREF="gtklist.html#GTK-LIST-REMOVE-ITEMS-NO-UNREF">gtk_list_remove_items_no_unref</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items);void <AHREF="gtklist.html#GTK-LIST-CLEAR-ITEMS">gtk_list_clear_items</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> start, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> end);void <AHREF="gtklist.html#GTK-LIST-SELECT-ITEM">gtk_list_select_item</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> item);void <AHREF="gtklist.html#GTK-LIST-UNSELECT-ITEM">gtk_list_unselect_item</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> item);void <AHREF="gtklist.html#GTK-LIST-SELECT-CHILD">gtk_list_select_child</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtkwidget.html">GtkWidget</A> *child);void <AHREF="gtklist.html#GTK-LIST-UNSELECT-CHILD">gtk_list_unselect_child</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtkwidget.html">GtkWidget</A> *child);<AHREF=../glib/glib-basic-types.html#GINT>gint</A> <AHREF="gtklist.html#GTK-LIST-CHILD-POSITION">gtk_list_child_position</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtkwidget.html">GtkWidget</A> *child);void <AHREF="gtklist.html#GTK-LIST-SET-SELECTION-MODE">gtk_list_set_selection_mode</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtk-standard-enumerations.html#GTKSELECTIONMODE">GtkSelectionMode</A> mode);void <AHREF="gtklist.html#GTK-LIST-EXTEND-SELECTION">gtk_list_extend_selection</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtk-standard-enumerations.html#GTKSCROLLTYPE">GtkScrollType</A> scroll_type, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> position, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> auto_start_selection);void <AHREF="gtklist.html#GTK-LIST-START-SELECTION">gtk_list_start_selection</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-END-SELECTION">gtk_list_end_selection</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-SELECT-ALL">gtk_list_select_all</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-UNSELECT-ALL">gtk_list_unselect_all</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-SCROLL-HORIZONTAL">gtk_list_scroll_horizontal</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtk-standard-enumerations.html#GTKSCROLLTYPE">GtkScrollType</A> scroll_type, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> position);void <AHREF="gtklist.html#GTK-LIST-SCROLL-VERTICAL">gtk_list_scroll_vertical</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtk-standard-enumerations.html#GTKSCROLLTYPE">GtkScrollType</A> scroll_type, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> position);void <AHREF="gtklist.html#GTK-LIST-TOGGLE-ADD-MODE">gtk_list_toggle_add_mode</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-TOGGLE-FOCUS-ROW">gtk_list_toggle_focus_row</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-TOGGLE-ROW">gtk_list_toggle_row</A> (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtkwidget.html">GtkWidget</A> *item);void <AHREF="gtklist.html#GTK-LIST-UNDO-SELECTION">gtk_list_undo_selection</A> (<AHREF="gtklist.html">GtkList</A> *list);void <AHREF="gtklist.html#GTK-LIST-END-DRAG-SELECTION">gtk_list_end_drag_selection</A> (<AHREF="gtklist.html">GtkList</A> *list); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN29634"></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> +----GtkList</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN29640"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtklist.html#GTKLIST-SELECTION-CHANGED">selection-changed</A>" void user_function (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtklist.html#GTKLIST-SELECT-CHILD">select-child</A>" void user_function (<AHREF="gtklist.html">GtkList</A> *list, <AHREF="gtkwidget.html">GtkWidget</A> *widget, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtklist.html#GTKLIST-UNSELECT-CHILD">unselect-child</A>" void user_function (<AHREF="gtklist.html">GtkList</A> *list, <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="AEN29654"></A><H2>Description</H2><P>The GtkList widget is a container whose children are displayedvertically in order, and can be selected.The list has many selection modes, which are programmer selective anddepend on how many elements are able to be selected at the same time.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN29657"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN29659"></A><H3><ANAME="GTKLIST-STRUCT"></A>struct GtkList</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkList;</PRE></TD></TR></TABLE><P></P><DIVCLASS="INFORMALTABLE"><ANAME="AEN29664"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFF0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN29669"></A><H3><ANAME="GTK-LIST-NEW"></A>gtk_list_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_list_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtklist.html">GtkList</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN29676"></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">the newly created <AHREF="gtklist.html">GtkList</A> </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN29686"></A><H3><ANAME="GTK-LIST-INSERT-ITEMS"></A>gtk_list_insert_items ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_list_insert_items (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);</PRE></TD></TR></TABLE><P>Inserts <TTCLASS="PARAMETER"><I>items</I></TT> into the <TTCLASS="PARAMETER"><I>list</I></TT> at the position <TTCLASS="PARAMETER"><I>position</I></TT>. The <TTCLASS="PARAMETER"><I>GList</I></TT> itemsmust not be freed after.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN29698"></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>list</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the list widget.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>items</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the items.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>position</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the position to insert <TTCLASS="PARAMETER"><I>items</I></TT>, starting at 0. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN29716"></A><H3><ANAME="GTK-LIST-APPEND-ITEMS"></A>gtk_list_append_items ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_list_append_items (<AHREF="gtklist.html">GtkList</A> *list, <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> *items);</PRE></TD></TR></TABLE><P>Adds <TTCLASS="PARAMETER"><I>items</I></TT> to the end of the <TTCLASS="PARAMETER"><I>list</I></TT>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN29725"></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>list</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the list widget.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>items</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the items. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN29738"></A><H3><ANAME="GTK-LIST-PREPEND-ITEMS"></A>gtk_list_prepend_items ()</H3><TABLEBORDER="0"⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -