GTK+ 2.0 Tutorial
<<< Previous | Menu Widget | Next >>>

# Manual Menu Example

That should about do it. Let's take a look at an example to help clarify.

    #include <stdio.h>
    #include <gtk/gtk.h>

    static gboolean button_press (GtkWidget *, GdkEvent *);
    static void menuitem_response (gchar *);

    int main( int   argc,
              char *argv[] )
    {

        GtkWidget *window;
        GtkWidget *menu;
        GtkWidget *menu_bar;
        GtkWidget *root_menu;
        GtkWidget *menu_items;
        GtkWidget *vbox;
        GtkWidget *button;
        char buf[128];
        int i;

        gtk_init (&argc, &argv);

        /* create a new window */
        window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
        gtk_widget_set_size_request (GTK_WIDGET (window), 200, 100);
        gtk_window_set_title (GTK_WINDOW (window), "GTK Menu Test");
        g_signal_connect (window, "delete-event",
                          G_CALLBACK (gtk_main_quit), NULL);

        /* Init the menu-widget, and remember -- never
         * gtk_show_widget() the menu widget!!
         * This is the menu that holds the menu items, the one that
         * will pop up when you click on the "Root Menu" in the app */
        menu = gtk_menu_new ();

        /* Next we make a little loop that makes three menu-entries for "test-menu".
         * Notice the call to gtk_menu_shell_append.  Here we are adding a list of
         * menu items to our menu.  Normally, we'd also catch the "clicked"
         * signal on each of the menu items and setup a callback for it,
         * but it's omitted here to save space. */

        for (i = 0; i < 3; i++)
            {
                /* Copy the names to the buf. */
                sprintf (buf, "Test-undermenu - %d", i);

                /* Create a new menu-item with a name... */
                menu_items = gtk_menu_item_new_with_label (buf);

                /* ...and add it to the menu. */
                gtk_menu_shell_append (GTK_MENU_SHELL (menu), menu_items);

    	    /* Do something interesting when the menuitem is selected */
    	    g_signal_connect_swapped (menu_items, "activate",
    		                      G_CALLBACK (menuitem_response),
                                          (gpointer) g_strdup (buf));

                /* Show the widget */
                gtk_widget_show (menu_items);
            }

        /* This is the root menu, and will be the label
         * displayed on the menu bar.  There won't be a signal handler attached,
         * as it only pops up the rest of the menu when pressed. */
        root_menu = gtk_menu_item_new_with_label ("Root Menu");

        gtk_widget_show (root_menu);

        /* Now we specify that we want our newly created "menu" to be the menu
         * for the "root menu" */
        gtk_menu_item_set_submenu (GTK_MENU_ITEM (root_menu), menu);

        /* A vbox to put a menu and a button in: */
        vbox = gtk_vbox_new (FALSE, 0);
        gtk_container_add (GTK_CONTAINER (window), vbox);
        gtk_widget_show (vbox);

        /* Create a menu-bar to hold the menus and add it to our main window */
        menu_bar = gtk_menu_bar_new ();
        gtk_box_pack_start (GTK_BOX (vbox), menu_bar, FALSE, FALSE, 2);
        gtk_widget_show (menu_bar);

        /* Create a button to which to attach menu as a popup */
        button = gtk_button_new_with_label ("press me");
        g_signal_connect_swapped (button, "event",
    	                      G_CALLBACK (button_press),
                                  menu);
        gtk_box_pack_end (GTK_BOX (vbox), button, TRUE, TRUE, 2);
        gtk_widget_show (button);

        /* And finally we append the menu-item to the menu-bar -- this is the
         * "root" menu-item I have been raving about =) */
        gtk_menu_shell_append (GTK_MENU_SHELL (menu_bar), root_menu);

        /* always display the window as the last step so it all splashes on
         * the screen at once. */
        gtk_widget_show (window);

        gtk_main ();

        return 0;
    }

    /* Respond to a button-press by posting a menu passed in as widget.
     *
     * Note that the "widget" argument is the menu being posted, NOT
     * the button that was pressed.
     */

    static gboolean button_press( GtkWidget *widget,
                                  GdkEvent *event )
    {

        if (event->type == GDK_BUTTON_PRESS) {
            GdkEventButton *bevent = (GdkEventButton *) event;
            gtk_menu_popup (GTK_MENU (widget), NULL, NULL, NULL, NULL,
                            bevent->button, bevent->time);
            /* Tell calling code that we have handled this event; the buck
             * stops here. */
            return TRUE;
        }

        /* Tell calling code that we have not handled this event; pass it on. */
        return FALSE;
    }

    /* Print a string when a menu item is selected */

    static void menuitem_response( gchar *string )
    {
        printf ("%s\n", string);
    }

You may also set a menu item to be insensitive and, using an accelerator table, bind keys to menu functions.

<<< Previous | Home | Next >>>
Menu Widget | Up | Using ItemFactory