gedit {gWidgets}R Documentation

Constructor for widget to handle single-line text input

Description

The gedit widget is used to enter single lines of text.

Usage

gedit(text = "", width = 25, coerce.with = NULL, handler = NULL, action = NULL, container = NULL, ..., toolkit = guiToolkit())

Arguments

text Initial text in widget
width Width of widget. For gedit, this means the number of characters.
coerce.with For gedit, when the value is retrieved this function is applied to the result. (The stored value is always a character, this can be used to make it numerc, to quote it, ...
handler Handler called when text is changed. For gedit, this means the enter key is pressed.
action Passed to handler
container Optional container to attach widget to
... Passed to add method of container
toolkit Which GUI toolkit to use

Details

The gedit widget has the following methods:

The svalue method retrieves the value. If a function is given to the argument coerce.with it is applied before the value is returned. This can be used to coerce the text value (always of class character) to a numeric, or to a date, or to be quoted, ...

The svalue<- method is used to set the value.

The "[" and "[<-" methods refer to the widgets "type-ahead" values. A familiar usage is when a url is typed into a web browser, matches appear from a users history that could possibly complete the typed url.

Examples

## Not run: 
        gedit("type here", container=gwindow())
        
        ## change handler
        obj <- gedit(container=gwindow())
        addhandlerchanged(obj, handler=function(h,...) 
          cat("You typed", svalue(h$obj),"\n"))

         ## coerce to numeric
         obj <- gedit("7", container=gwindow(), coerce.with=as.numeric)
         svalue(obj)

## End(Not run)

[Package gWidgets version 0.0-35 Index]