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