R: Display a Data Frame in a Tk Text Widget

showData {relimp} | R Documentation

## Display a Data Frame in a Tk Text Widget

### Description

Displays the contents of a data frame in a modeless Tk text window, for inspection. Objects not of class `data.frame`, for example objects of class `table`, or `matrix`, are coerced using `as.data.frame` prior to display.

### Usage

    showData(dataframe,
           colname.bgcolor = "grey50",
           rowname.bgcolor = "grey50",
           body.bgcolor = "white",
           colname.textcolor = "white",
           rowname.textcolor = "white",
           body.textcolor = "black",
           font = "Courier 12",
           maxheight = 30,
           maxwidth = 80,
           title = NULL,
           rowname.bar = "left",
           colname.bar = "top",
           rownumbers = FALSE,
           placement = "-20-40",
           suppress.X11.warnings = TRUE)

### Arguments

`dataframe` | A data frame, or an object to which `as.data.frame()` can be validly applied
`colname.bgcolor` | A background colour for the variable-names panel
`rowname.bgcolor` | A background colour for the row-names panel
`body.bgcolor` | A background colour for the data
`colname.textcolor` | A colour for the variable names
`rowname.textcolor` | A colour for the row names
`body.textcolor` | A colour for the data
`font` | The text font used – should be a monospaced font
`maxheight` | The maximum number of rows to display
`maxwidth` | The maximum width of display, in characters
`title` | A title for the window. Default is to use the name of the dataframe as given in the call to `showData()`
`rowname.bar` | position of sidebar for row names, `"left"` or `"right"`, or `c("left","right")`, or `NULL`
`colname.bar` | position of column names, `"top"` or `"bottom"`, or `c("top","bottom")`, or `NULL`
`rownumbers` | logical, whether row numbers should be displayed
`placement` | Position of the bottom right corner of the window
`suppress.X11.warnings` | logical, if `TRUE` then any X11 warnings are suppressed

### Value

Invisibly returns the Tk window containing the displayed data frame.

### Note

An error results if the printed representation of `dataframe` exceeds the maximum allowed width of 10000 characters; see `options`.

Text can be copied from the Tk window to the system clipboard, using <Control-C> or via a right-click pop-up menu.

On some systems the window may take a few seconds to appear if the data frame is very large.

### Author(s)

David Firth, d.firth@warwick.ac.uk; with Rcmdr-specific features contributed by John Fox

### Examples

    ## This cannot be run by example() but should be OK when pasted
    ## into an interactive R session
    ## Not run:
    data(mtcars)
    showData(mtcars)
    ## End(Not run)

[Package relimp version 1.0-5 Index]