gWidgetsRGtk2-package {gWidgetsRGtk2} | R Documentation |
Port of gWidgets API to RGtk2
This package allows the gWidgets API to use the RGtk2 package allowing the use of the GTK libraries within R. The documentation for the functions in this package are contained in the gWidgets package.
As gWidgets is meant to be multi-toolkit, this file documents differences from the API, as defined by the man pages of the gWidgets package.
Containers:
To access the underlying gtk container from a gframe
object
one uses getToolkitWidget(obj)$getParent()
Widgets:
For the data frame viewer gtable
when no filtering is
requested, the default, the column headers can be clicked to sort the values.
In the data frame editor gdf
the subset
option only works if the
column names have not been changed.
The gaction
constructor produces action objects. The
enabled<-
method can be used to set their sensitivity. The
objects can be used with gbutton
through the action
argument, and in the lists defining menubars and toolbars. The
key.accel
argument of the constructor is ignored for now. The
tooltip
is OS sensitive, as it depends on the event loop
implementation.
The gtoolbar
list can have components that are a) lists with
a handler componented, b) lists with a separator component, c)
gaction instances d) gWidgets, in which case the widget appears in
the toolbar. The latter is not portable to other gWidgets
implementations.
Methods:
The font
method is not implemented.
For widgets which allow markup (gframe
, glabel
) PANGO
markup is used. This is not HTML, but is similar to basic HTML.
gWidgetsRGtk2 and the RGtk2 package:
The RGtk2 package is imported only so its namespace, which is
large, is not loaded by default. To access its functions, load the
package.
The RGtk2 package and gWidgetsRGtk2 can be used together
in the following ways. First, an RGtk2 object can be added to
a gWidgetsRGtk2 through the add
method of the
container. This works for most objects. If you find one that doesn't
work, simply place it inside a gtkHBox
container, then add
that container. Second, a gWidgetsRGtk2 object can be added to
to a RGtk2 container by adding the return value of the
getToolkitWidget
method of the object. Again, this should
work, but if not, the gWidgetsRGtk2 can be added to a
ggroup
container first. In either case, the
gWidgetsRGtk2 object should not be attached to a container, so
in particular the constructor should be called with its
container
argument as NULL
(the default).
Michael Lawrence, John Verzani
Maintainer: John Verzani <gwidgetsrgtk@gmail.com>
gWidgets