## 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 and GtkBuildable.

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