Learn R Programming

RGtk2 (version 2.8.8)

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, parent.menu.item, func, 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

\link{GObject} +----\link{GtkObject} +----\link{GtkWidget} +----\link{GtkContainer} +----\link{GtkMenuShell} +----GtkMenu

Interfaces

GtkMenu implements AtkImplementorIface.

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. # connect our handler which will popup the menu gSignalConnect(window, "button_press_event", my_popup_handler, menu, user.data.first=T) # 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