gtext {gWidgets} | R Documentation |
The
gtext
widget creates a text buffer for handling multiple lines
of text.
gtext (text = NULL, width = NULL, height = 300, font.attr = NULL, wrap = TRUE, handler = NULL, action = NULL, container = NULL, ..., toolkit = guiToolkit())
text |
Initial text in widget |
width |
Width of widget in pixels |
height |
Height of gtext widget in pixels |
font.attr |
Optional specification of font attributes |
wrap |
For gtext, are long lines wrapped? |
handler |
Handler called when text is changed. |
action |
Passed to handler |
container |
Optional container to attach widget to |
... |
Passed to add method of container |
toolkit |
Which GUI toolkit to use |
The gtext
widget has the following methods.
The svalue
method returns the text held in the
buffer. If drop=TRUE
, then only the text in the buffer
selected by the mouse is returned.
The svalue<-
method replaces the text in the buffer
with the new text.
New text is added with the add
method. The basic usage
is add(obj,text)
where "text" could be a single line or
a vector of text, or a gwidget (although some, like gedit, are kind of
flaky). Extra arguments include do.newline
a
logical indicating if a new line after the last line should be
added (default is TRUE
); font.attr
to specify
any font attributes; where
indicating where to add the
text (either end
or beginning
).
The font can be changed. The font.attr
argument to the
constructon and to add
specifies fonts using a
namedcharacter vector. For instance
c(style="normal", weights="bold",sizes="medium")
.
The command obj[['tags']]
will produce a list
containing all the available attributes.
The font<-
method is used to change the font of the
currently selected text. It too takes a named character vector
specifying the font attributes.
The dispose
method clears the text in the buffer.
The addHandlerKeystroke
method for gedit
and
gtext
is called for
each keystroke. In gtext
or RGtk2
the component
key
of the h
argument contains the keystroke.
## Not run: ## gtext example obj <- gtext("First line", container=gwindow()) add(obj,"second line", font.attr=c(family="monospace")) add(obj,"third line", font.attr=c(foreground.colors="red")) ## End(Not run)