The R Project SVN R

Rev

Rev 59039 | Rev 69711 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
42333 ripley 1 
% File src/library/utils/man/View.Rd
2 
% Part of the R package, http://www.R-project.org
59039 ripley 3 
% Copyright 1995-2009 R Core Team
42333 ripley 4 
% Distributed under GPL 2 or later
5 
 
40750 ripley 6 
\name{View}
56186 murdoch 7 
\alias{View}
40750 ripley 8 
\title{Invoke a Data Viewer}
9 
\description{
40755 ripley 10 
  Invoke a spreadsheet-style data viewer on a matrix-like \R object.
40750 ripley 11 
}
12 
\usage{
13 
View(x, title)
14 
}
15 
\arguments{
40755 ripley 16 
  \item{x}{an \R object which can be coerced to a data frame with
17 
    non-zero numbers of rows and columns.}
49023 ripley 18 
  \item{title}{title for viewer window.  Defaults to name of \code{x}
19 
    prefixed by \code{Data:}.}
40750 ripley 20 
}
21 
\details{
22 
  Object \code{x} is coerced (if possible) to a data frame, and all
23 
  non-numeric columns are then coerced to character.   The object is
24 
  then viewed in a spreadsheet-like data viewer, a read-only version of
25 
  \code{\link{data.entry}}.
40755 ripley 26 
 
27 
  If there are row names on the data frame that are not \code{1:nrow},
28 
  they are displayed in a separate first column called \code{row.names}.
29 
 
30 
  Objects with zero columns or zero rows are not accepted.
31 
#ifdef unix
32 
 
33 
  The array of cells can be navigated by the cursor keys and Home, End,
34 
  Page Up and Page Down (where supported by X11) as well as Enter
35 
  and Tab.
36 
#endif
37 
#ifdef windows
38 
 
39 
  The array of cells can be navigated \emph{via} the scrollbars and
40 
  by the cursor keys, Home, End, Page Up and Page Down.
49023 ripley 41 
 
48873 murdoch 42 
  The initial size of the data viewer window is taken from the default
47875 ripley 43 
  dimensions of a pager (see \code{\link{Rconsole}}), but adjusted
61433 ripley 44 
  downwards to show a whole number of rows and columns.
40755 ripley 45 
#endif
40750 ripley 46 
}
47 
\value{
48 
  Invisible \code{NULL}.  The functions puts up a window and returns
40755 ripley 49 
  immediately: the window can be closed via its controls or menus.
40750 ripley 50 
}
51 
\seealso{
52 
  \code{\link{edit.data.frame}},
53 
  \code{\link{data.entry}}.
54 
}
55 
\keyword{utilities}