GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkItem

## Name

GtkItem -- abstract base class for GtkMenuItem, GtkListItem and GtkTreeItem.

## Synopsis

    #include <gtk/gtk.h>

    struct      GtkItem;
    void        gtk_item_select                 (GtkItem *item);
    void        gtk_item_deselect               (GtkItem *item);
    void        gtk_item_toggle                 (GtkItem *item);

## Object Hierarchy

      GtkObject
       +----GtkWidget
             +----GtkContainer
                   +----GtkBin
                         +----GtkItem

## Signal Prototypes

    "select"    void        user_function      (GtkItem *item,
                                                gpointer user_data);
    "deselect"  void        user_function      (GtkItem *item,
                                                gpointer user_data);
    "toggle"    void        user_function      (GtkItem *item,
                                                gpointer user_data);

## Description

The GtkItem widget is an abstract base class for GtkMenuItem, GtkListItem and GtkTreeItem.

## Details

### struct GtkItem

    struct GtkItem;

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

### gtk_item_select ()

    void        gtk_item_select                 (GtkItem *item);

Emits the "select" signal on the given item.

`item` : | a GtkItem.

### gtk_item_deselect ()

    void        gtk_item_deselect               (GtkItem *item);

Emits the "deselect" signal on the given item.

`item` : | a GtkItem.

### gtk_item_toggle ()

    void        gtk_item_toggle                 (GtkItem *item);

Emits the "toggle" signal on the given item.

`item` : | a GtkItem.

## Signals

### The "select" signal

    void        user_function                  (GtkItem *item,
                                                gpointer user_data);

Emitted when the item is selected.

`item` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The "deselect" signal

    void        user_function                  (GtkItem *item,
                                                gpointer user_data);

Emitted when the item is deselected.

`item` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The "toggle" signal

    void        user_function                  (GtkItem *item,
                                                gpointer user_data);

Emitted when the item is toggled.

`item` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

<<< Previous Page | Home | Up | Next Page >>>
GtkInvisible | GtkItemFactory