## 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 AtkImplementorIface.

## Signals

      end-selection                                  : Run Last / Action
      extend-selection                               : Run Last / Action
      scroll-horizontal                              : Run Last / Action
      scroll-vertical                                : Run Last / Action
      select-all                                     : Run Last / Action
      start-selection                                : Run Last / Action
      toggle-add-mode                                : Run Last / Action
      toggle-focus-row                               : Run Last / Action
      undo-selection                                 : Run Last / Action
      unselect-all                                   : 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.