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

# GtkTearoffMenuItem

## Name

GtkTearoffMenuItem -- a menu item used to tear off and reattach its menu.

## Synopsis

    #include <gtk/gtk.h>

    struct      GtkTearoffMenuItem;
    GtkWidget*  gtk_tearoff_menu_item_new       (void);

## Object Hierarchy

      GObject
       +----GtkObject
             +----GtkWidget
                   +----GtkContainer
                         +----GtkBin
                               +----GtkItem
                                     +----GtkMenuItem
                                           +----GtkTearoffMenuItem

## Description

a GtkTearoffMenuItem is a special GtkMenuItem which is used to tear off and reattach its menu.

When its menu is shown normally, the GtkTearoffMenuItem is drawn as a dotted line indicating that the menu can be torn off. Activating it causes its menu to be torn off and displayed in its own window as a tearoff menu.

When its menu is shown as a tearoff menu, the GtkTearoffMenuItem is drawn as a dotted line which has a left pointing arrow graphic indicating that the tearoff menu can be reattached. Activating it will erase the tearoff menu window.

## Details

### struct GtkTearoffMenuItem

    struct GtkTearoffMenuItem;

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

### gtk_tearoff_menu_item_new ()

    GtkWidget*  gtk_tearoff_menu_item_new       (void);

Creates a new GtkTearoffMenuItem.

Returns : | a new GtkTearoffMenuItem.

## See Also

GtkMenu

  for further discussion of menus in GTK.

<<< Previous Page | Home | Up | Next Page >>>
GtkSeparatorMenuItem | GtkToolbar