gWidgets-dialogs {gWidgets} | R Documentation |
A dialog is a widget that draws its own window. These dialogs are used for simple things – confirming a choice, gathering a single line of input, etc. Dialogs are always modal, meaning they must be closed before R can be interacted with again.
gmessage(message, icon = c("info", "warning", "error", "question"), button = c("close", "ok", "cancel"), handler = NULL, action = NULL, ..., toolkit=guiToolkit()) ginput(message, icon = c("info", "warning", "error", "question"), handler = NULL, action = NULL,..., toolkit=guiToolkit()) gconfirm(message, icon = c("info", "warning", "error", "question"), handler = NULL, action = NULL, ..., toolkit=guiToolkit()) gbasicdialog(message, title = "Dialog", widget, icon = c("info", "warning", "error", "question"), handler = NULL, action=NULL, ..., toolkit=guiToolkit())
message |
Message shown for widget |
title |
Title of window |
icon |
Which icon to show |
button |
Which button to show |
widget |
Widget to place in basic dialog |
handler |
Handler called on OK selection. |
action |
Value passed to handler |
... |
Ignored |
toolkit |
Toolkit to use for GUI |
These basic dialogs do slightly different things.
The gmessage
dialog shows a message with an icon and a dismiss
button. This dialog returns TRUE
or FALSE
as
appropriate.
The gconfirm
dialog shows a message with an icon and an OK
button and a dismiss button. A handler may be attached to the OK
button selection. This dialog returns TRUE
or FALSE
as
appropriate.
The ginput
dialog adds an edit box for gathering user
information. This is then passed to the handler via the component
input
of the first argument of the handler. This dialog
returns FALSE
or the effect of calling svalue
on the
input value.
The gbasicdialog
dialog wraps a widget around an OK and dismiss
button. The handler is called when the OK button is clicked. This
dialog returns the widget when OK is clicked, otherwise FALSE
.
These dialogs are modal. This means that the R session freezes until the dialog is dismissed. This may be confusing to users if the window should appear below a currently drawn window.
## Not run: gmessage("Hi there") gconfirm("Are we having fun?", handler = function(h,...) print("Yes")) ginput("Enter your name", icon="question", handler = function(h,...) cat("Hi",h$input,"\n")) ## End(Not run)