GtkListItem

GtkListItem — An item in a GtkList

Synopsis


#include <gtk/gtk.h>


            GtkListItem;
GtkWidget*  gtk_list_item_new               (void);
GtkWidget*  gtk_list_item_new_with_label    (const gchar *label);
void        gtk_list_item_select            (GtkListItem *list_item);
void        gtk_list_item_deselect          (GtkListItem *list_item);


Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkItem
                                       +----GtkListItem

Implemented Interfaces

GtkListItem implements GtkBuildable and AtkImplementorIface.

Signals


"end-selection"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action
"extend-selection"
            void        user_function      (GtkListItem  *listitem,
                                            GtkScrollType scroll_type,
                                            gfloat        position,
                                            gboolean      auto_start_selection,
                                            gpointer      user_data)                 : Run last / Action
"scroll-horizontal"
            void        user_function      (GtkListItem  *listitem,
                                            GtkScrollType scroll_type,
                                            gfloat        position,
                                            gpointer      user_data)        : Run last / Action
"scroll-vertical"
            void        user_function      (GtkListItem  *listitem,
                                            GtkScrollType scroll_type,
                                            gfloat        position,
                                            gpointer      user_data)        : Run last / Action
"select-all"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action
"start-selection"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action
"toggle-add-mode"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action
"toggle-focus-row"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action
"undo-selection"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action
"unselect-all"
            void        user_function      (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

Description

The GtkListItem widget is used for each item in a GtkList.

GtkList has has been deprecated since GTK+ 2.0 and should not be used in newly written code. Use GtkTreeView instead.

Details

GtkListItem

typedef struct _GtkListItem GtkListItem;

Warning

GtkListItem is deprecated and should not be used in newly-written code.

The GtkListItem struct contains private data only, and should only be accessed using the functions below.


gtk_list_item_new ()

GtkWidget*  gtk_list_item_new               (void);

Warning

gtk_list_item_new is deprecated and should not be used in newly-written code.

Creates a new GtkListitem.

Returns : a new GtkListItem.

gtk_list_item_new_with_label ()

GtkWidget*  gtk_list_item_new_with_label    (const gchar *label);

Warning

gtk_list_item_new_with_label is deprecated and should not be used in newly-written code.

Creates a new GtkListItem with a child label containing the given string.

label : the string to use for the child label.
Returns : a new GtkListItem with a child GtkLabel with the text set to label.

gtk_list_item_select ()

void        gtk_list_item_select            (GtkListItem *list_item);

Warning

gtk_list_item_select is deprecated and should not be used in newly-written code.

Selects the item, by emitting the item's "select" signal. Depending on the selection mode of the list, this may cause other items to be deselected.

list_item : a GtkListItem.

gtk_list_item_deselect ()

void        gtk_list_item_deselect          (GtkListItem *list_item);

Warning

gtk_list_item_deselect is deprecated and should not be used in newly-written code.

Deselects the item, by emitting the item's "deselect" signal.

list_item : a GtkListItem.

Signal Details

The "end-selection" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "extend-selection" signal

void        user_function                  (GtkListItem  *listitem,
                                            GtkScrollType scroll_type,
                                            gfloat        position,
                                            gboolean      auto_start_selection,
                                            gpointer      user_data)                 : Run last / Action

listitem : the object which received the signal.
scroll_type :
position :
auto_start_selection :
user_data : user data set when the signal handler was connected.

The "scroll-horizontal" signal

void        user_function                  (GtkListItem  *listitem,
                                            GtkScrollType scroll_type,
                                            gfloat        position,
                                            gpointer      user_data)        : Run last / Action

listitem : the object which received the signal.
scroll_type :
position :
user_data : user data set when the signal handler was connected.

The "scroll-vertical" signal

void        user_function                  (GtkListItem  *listitem,
                                            GtkScrollType scroll_type,
                                            gfloat        position,
                                            gpointer      user_data)        : Run last / Action

listitem : the object which received the signal.
scroll_type :
position :
user_data : user data set when the signal handler was connected.

The "select-all" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "start-selection" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "toggle-add-mode" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "toggle-focus-row" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "undo-selection" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "unselect-all" signal

void        user_function                  (GtkListItem *listitem,
                                            gpointer     user_data)      : Run last / Action

listitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

See Also

GtkList

the parent list widget.