1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
\name{gedit}
\alias{gedit}
\title{Constructor for widget to handle single-line text input}
\description{
The \code{gedit} widget is used to enter single lines of text.
}
\usage{
gedit(text = "", width = 25, coerce.with = NULL, initial.msg="",
handler = NULL, action = NULL, container = NULL, ..., toolkit = guiToolkit())
}
\arguments{
\item{text}{Initial text in widget}
\item{width}{Width of widget. For gedit, this means the number of
characters.}
\item{coerce.with}{For gedit, when the value is retrieved this
function is applied to the result. (The stored value is always a
character, this can be used to make it numerc, to quote it, ...}
\item{initial.msg}{If \code{text} is empty, this initial message is displayed to give the user some indication of what to do}
\item{handler}{Handler called when text is changed. For gedit, this
means the enter key is pressed.}
\item{action}{ Passed to handler}
\item{container}{Optional container to attach widget to}
\item{\dots}{Passed to add method of container}
\item{toolkit}{Which GUI toolkit to use}
}
\details{
The \code{gedit} widget has the following methods:
The \code{svalue} method retrieves the value. If a function is
given to the argument \code{coerce.with} it is applied before
the value is returned. This can be used to coerce the text
value (always of class character) to a numeric, or to a date,
or to be quoted, ...
The \code{svalue<-} method is used to set the value.
The \code{"["} and \code{"[<-"} methods refer to the widgets
"type-ahead" values. A familiar usage is when a url is typed
into a web browser, matches appear from a users history that
could possibly complete the typed url.
The \code{visible<-} method is used to toggle whether
characters are visible, or are replaced with a "*", such as is
done with password entry.
}
% \value{}
% \references{}
% \author{}
% \note{}
% \seealso{}
\examples{
\dontrun{
gedit("type here", container=gwindow())
## change handler
obj <- gedit(container=gwindow())
addhandlerchanged(obj, handler=function(h,...)
cat("You typed", svalue(h$obj),"\n"))
## coerce to numeric
obj <- gedit("7", container=gwindow(), coerce.with=as.numeric)
svalue(obj)
}
}
\keyword{interface }
|
