gradio {gWidgets} | R Documentation |
Widgets to select one (or several) from a given vector of items. These are a radio group where all values are shown at once, but only one may be selected; a checkbox group where more than one may be selected; and a droplist where initially only a single value is shown, and the others are a mouse click away,
gradio(items, selected = 1, horizontal = FALSE, handler = NULL, action = NULL, container = NULL, ..., toolkit = guiToolkit()) gdroplist(items, selected = 1, editable = FALSE, coerce.with=NULL, handler = NULL, action = NULL, container = NULL, ..., toolkit = guiToolkit()) gcheckboxgroup(items, checked = FALSE, horizontal = FALSE, handler = NULL, action = NULL, container = NULL, ..., toolkit = guiToolkit())
items |
Vector of values to select from |
selected |
For gradio the initial selected value (as an index) For a drop list, the first selected value. Use 0 to leave blank |
checked |
For gcheckboxgroup a logical vector of initial values. |
editable |
For gdroplist, a logical indicating if the user can add an entry to the list of available answers |
coerce.with |
Apply this function to selected value before returning |
horizontal |
A logical specifying the layout for gradio and gcheckboxgroup |
handler |
Called when selection is changed |
action |
Passed to handler when called. |
container |
Optional container to attach widget to |
... |
Ignored |
toolkit |
Which GUI toolkit to use |
The basic methods all work similarly for these three widgets.
The svalue
method returns the selected values by
name. If the extra argument index=TRUE
is specified,
the indices of the selected values is given.
The svalue<-
method can be used to set the selected
value.
The "["
method refers to the vector defining the items.
The "[<-"
method can be used to change the vector
defining the items.
For gdroplist
the argument editable=TRUE
adds a
text-edit box where the user can type in a selection. By
default this value is returned as a character by
svalue
. Use coerce.with
to coerce this prior to returning.
## Not run: flavors = c("vanilla", "chocolate", "strawberry") group = ggroup(container=TRUE) add(group,glabel("Favorite flavor:")) add(group, gradio(flavors)) group = ggroup(container=TRUE) add(group,glabel("Favorite flavor:")) add(group, gdroplist(flavors, editable =TRUE)) group = ggroup(container=TRUE) add(group,glabel("Favorite flavors:")) add(group, obj <- gcheckboxgroup(flavors)) svalue(obj) <- c(TRUE, FALSE, TRUE) svalue(obj) obj[3] <- "raspberry" ## End(Not run)