gui-utilities {zooimage} | R Documentation |
These functions are usually not called directly by the user, but they are interesting for developers. They allow to select elements through dialog boxes.
selectObject(class = "data.frame", default = "", multiple = FALSE,
title = paste0("Choose a ", class, ":"))
selectList(class = "data.frame", default = "", multiple = FALSE,
title = paste0("Choose a list (of ", class, "s):"))
selectFile(type = c("ZipZid", "ZimZis", "LstZid", "ZidZidb", "Zip", "Zid", "Zidb",
"Zim", "Zis", "Zie", "Zic", "Img", "TifPgm", "RData"), multiple = FALSE,
quote = TRUE, title = NULL)
selectGroups(groups, multiple = TRUE, title = "Select taxa you want to plot")
createThreshold(ZIDat)
imageViewer(dir = getwd(), pgm = getOption("ZI.ImageViewer"))
startPgm(program, cmdline = "", switchdir = FALSE, iconize = FALSE, wait = FALSE)
modalAssistant(title, text, init, options = NULL, check = NULL,
select.file = NULL, returnValOnCancel = "ID_CANCEL", help.topic = NULL)
class |
the class of objects to retrieve (or class of list components
for |
default |
the default item selected in the list. |
multiple |
are multiple selections allowed? |
title |
the title of the dialog box. |
type |
the type of file to list in selection dialog box. |
quote |
do we add quotes (\") around file names? |
groups |
a list of groups to select from. |
ZIDat |
a ZIDat object. |
dir |
directory to open in the image viewer. |
pgm |
program to use as image viewer. If not provided and not defined
in the |
program |
name of the program to start. It must match an entry in R options giving the actual executable that correspond to that program. |
cmdline |
the command line to run to start this program. |
switchdir |
do we switch R current directory to the directory where the program is located? |
iconize |
in case the ZooImage assistant is open, do we iconize it? |
wait |
do we wait that the external program is closed? |
text |
textual explanations to show in the modal assistant. |
init |
initial values for the modal assistant. |
options |
options to select in the modal assistant. |
check |
checkbox to add in the modal assistant. |
select.file |
prompt for a file to select in the modal assistant. |
returnValOnCancel |
what to return if the user clicks the Cancel button in the modal assistant dialog box? |
help.topic |
help topic to associate with the Help button of the modal assistant dialog box. |
As these functions are not made to be directly used by end-users, We don't give more details here. Developers interested to use these functions are encouraged to look at their code in the zooimage package source!
A string or vector of strings of selected items. character(0)
is
returned to indicate the user clicked 'Cancel', while an empty string
(""
) is returned in case there is no corresponding element found.
createThreshold()
proposes a dialog box to create a threshold on one
variable in a ZIDat object (indicate minimum and maximum value allowed for
that variable).
For imageViewer()
, TRUE
or FALSE
is returned invisibly,
depending if the program could be lauched or not. The problem is reported in
a warning.
startPgm()
is mostly invoked for its side effect of starting an
external program. Status code returned by the program is returned if
wait = TRUE
.
modalAssistant()
is currently disabled, and it will thus display no
dialog box and return returnValOnCancel
directly.
Philippe Grosjean <Philippe.Grosjean@umons.ac.be>
## Not run:
## Create two datasets in R and ask for selecting one:
df1__ <- data.frame(x = 1:3, y = 4:6)
df2__ <- data.frame(z = 1:10)
selectObject() # Try also to click 'Cancel'
## Can select both too
selectObject(multiple = TRUE, title = "Choose one or more data.frames")
selectObject("nonexistingclass") # Returns an empty string!
## Create lists containing only data frames as components
lst1__ <- list(A = df1__, B = df2__)
lst2__ <- list(C = df1__)
selectList() # Try also to click 'Cancel'
## Can select both too
selectList(multiple = TRUE, title = "Select one or more lists")
selectList("nonexistingclass")
rm(df1__, df2__, lst1__, lst2__)
## Select one or more ZooImage files
selectFile() # One Zip or Zid file
## Select groups to process
selectGroups(c("Copepods", "Appendicularians", "Medusae"))
## Start default image viewer on the current working directory
imageViewer()
## TODO: examples for createThreshold(), startPgm() and modalAssistant()
## End(Not run)