gdf {gWidgets} | R Documentation

## Constructor of widget to edit a data frame

### Description

A widget used to edit data frames

### Usage

    gdf(items = NULL, name = deparse(substitute(items)), do.subset = FALSE,
    container = NULL, ...,toolkit = guiToolkit())

    gdfnotebook(items = NULL, container = NULL, ..., toolkit=guiToolkit())

### Arguments

`items` | data frame to be edited
`name` | Name of data frame
`do.subset` | A logical. If `TRUE` a means to filter the output using logical values is given.
`container` | An optional container to attach widget to
`...` | Can be used to overide default colors.
`toolkit` | Which GUI toolkit to use

### Details

This widget is similar to that provided by `gtable` only this is intended for editing of data frames. The `gdfnotebook` widget uses a notebook to hold several data frames at once.

In gWidgetsRGtk2, the table shown can be edited. Double click in a cell to allow this. When editing, the value is saved when the cell is left. This is done using the up or down arrow keys, the Enter key, the Tab key or the mouse. The down arrow key moves the cursor down a row, extending the size of the data frame if necessary. The Enter key moves the cursor down, but does not extend the data frame if at the bottom. The Tab key moves to the right. If at the end, a dialog to add a new variable pops up.

Right clicking in a cell that is not currently being edited pops up a menu to edit the colum names, sort or apply a function to a row.

If `do.subset=TRUE` then one can filter using subsetting by a single variable. The variable may be selected by a droplist, the logical expression can be entered or one selected from a droplist.

If more complicated filtering is desired, the `visible<-` method may be used, its value should a logical vector of length given by the number of rows of the data frame.

The `svalue` method returns the selected value.

The `svalue<-` method is used to select rows without a moust, the value is a set of row numbers.

The `"["` method is used for data-frame like extraction from the object.

The `"[<-"` method can be used for data-frame like assignment, with limitations.

The `dim`, `dimnames`, `dimnames<-`, `length`, `names` , and `names<-` methods should work on the object as they do for data frames.

The `addhandlerchanged` handler responds to changes in the values of the data frame.

### See Also

`gtable`

### Examples

    ## Not run:
            obj <- gdf(mtcars, container=gwindow("mtcars"), do.subset=TRUE)
            obj[1,1]
            obj[1,]
            obj[,1]
            obj[1,1] <- 21
            obj[,] <- head(mtcars) ## replace df
    ## End(Not run)

[Package gWidgets version 0.0-39 Index]