Learn R Programming

RGtk2 (version 2.12.17)

GtkMenu: GtkMenu

Description

A menu widget

Arguments

Methods and Functions

gtkMenuNew(show = TRUE) gtkMenuSetScreen(object, screen = NULL) gtkMenuReorderChild(object, child, position) gtkMenuAttach(object, child, left.attach, right.attach, top.attach, bottom.attach) gtkMenuPopup(object, parent.menu.shell = NULL, parent.menu.item = NULL, func = NULL, data = NULL, button, activate.time) gtkMenuSetAccelGroup(object, accel.group) gtkMenuGetAccelGroup(object) gtkMenuSetAccelPath(object, accel.path) gtkMenuSetTitle(object, title) gtkMenuGetTearoffState(object) gtkMenuGetTitle(object) gtkMenuPopdown(object) gtkMenuReposition(object) gtkMenuGetActive(object) gtkMenuSetActive(object, index) gtkMenuSetTearoffState(object, torn.off) gtkMenuAttachToWidget(object, attach.widget) gtkMenuDetach(object) gtkMenuGetAttachWidget(object) gtkMenuGetForAttachWidget(object) gtkMenuSetMonitor(object, monitor.num) gtkMenu(show = TRUE)

Hierarchy

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkMenuShell +----GtkMenu +----GtkRecentChooserMenu

Interfaces

GtkMenu implements AtkImplementorIface and GtkBuildable.

Detailed Description

A GtkMenu is a GtkMenuShell that implements a drop down menu consisting of a list of GtkMenuItem objects which can be navigated and activated by the user to perform application functions. A GtkMenu is most commonly dropped down by activating a GtkMenuItem in a GtkMenuBar or popped up by activating a GtkMenuItem in another GtkMenu. A GtkMenu can also be popped up by activating a GtkOptionMenu. Other composite widgets such as the GtkNotebook can pop up a GtkMenu as well. Applications can display a GtkMenu as a popup menu by calling the gtkMenuPopup function. The example below shows how an application can pop up a menu when the 3rd mouse button is pressed. Connecting the popup signal handler. ## connect our handler which will popup the menu gSignalConnect(window, "button_press_event", my_popup_handler, menu, user.data.first=TRUE) Signal handler which displays a popup menu. # The popup handler my_popup_handler <- function(widget, event) { stopifnot(widget != NULL) checkPtrType(widget, "GtkMenu") stopifnot(event != NULL)

## The "widget" is the menu that was supplied when ## gSignalConnect() was called. menu <- widget

if (event[["type"]] == "button-press") { if (event[["button"]] == 3) { menu$popup(button=event[["button"]], activate.time=event[["time"]]) return(TRUE) } }

return(FALSE) }

Convenient Construction

gtkMenu is the equivalent of gtkMenuNew.

References

http://developer.gnome.org/doc/API/2.0/gtk/GtkMenu.html