run.simplepanel(P, popup=TRUE, verbose = FALSE)
clear.simplepanel(P)
redraw.simplepanel(P, verbose = FALSE)
"simplepanel"
,
created by simplepanel
or grow.simplepanel
).popup=TRUE
(the default),
the panel will be displayed in a
new popup window. If popup=FALSE
,
the panel will be displayed on the current graphics
window if it already exists, and on a new window otherwiTRUE
, debugging information will be printed.run.simplepanel(P)
is the value returned
by the exit
function of P
. See simplepanel
. The functions clear.simplepanel
and redraw.simplepanel
return NULL
.
The argument P
is an object of class "simplepanel"
,
created by simplepanel
or grow.simplepanel
,
which specifies the graphics to be displayed and the actions to be performed
when the user interacts with the panel.
The command run.simplepanel(P)
activates the panel:
the display is initialised and the graphics system waits for the
user to click the panel.
While the panel is active, the user can only interact with the panel;
the Rcommand line interface and the RGUI cannot be used.
When the panel terminates (typically because the user
clicked a button labelled Exit), control returns to the Rcommand line
interface and the RGUI.
The command clear.simplepanel(P)
clears all the display
elements in the panel, resulting in a blank display except for the
title of the panel.
The command redraw.simplepanel(P)
redraws all the buttons
of the panel, according to the redraw
functions contained
in the panel.
If popup=TRUE
(the default), run.simplepanel
begins by
calling dev.new
so that a new popup window
is created; this window is closed using
dev.off
when run.simplepanel
terminates.
If popup=FALSE
, the panel will be displayed on the current graphics
window if it already exists, and on a new window otherwise;
this window is not closed when run.simplepanel
terminates.
For more sophisticated control of the graphics focus (for example, to
use the panel to control the display on another window),
initialise the graphics devices yourself using
dev.new
or similar commands; save these devices
in the shared environment env
of the panel P
;
and write the click/redraw functions of P
in such a way that
they access these devices using dev.set
.
Then use run.simplepanel
with popup=FALSE
.
simplepanel
if(interactive()) {
example(simplepanel)
run.simplepanel(P)
}
Run the code above in your browser using DataLab