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