gnotebook {gWidgets} | R Documentation

## constructor for notebook widget

### Description

A notebook widget organizes different pages using tabs, allowing only one page to be shown at once. Clicking on the tab raises the associated page.

### Usage

    gnotebook(tab.pos = 3, closebuttons = FALSE, dontCloseThese = NULL, container = NULL, ..., toolkit = guiToolkit())

### Arguments

`tab.pos` | Where to place tabs (1 bottom, 2 left side, 3 top, 4 right side
`closebuttons` | Is there a close button in the tab?
`dontCloseThese` | If `closebuttons=TRUE` this will make it impossible to remove these tabs. Specified by tab number
`container` | Optional container to attach notebook widget to
`...` | Not utilized
`toolkit` | Which GUI toolkit to use

### Details

In what follows, it is useful to think of a notebook as a vector with named entries, each entry being a widget, the name being the tab label.

Notebooks have the following methods:

The `svalue` method returns the current page number. The `svalue<-` method is used to set the page number.

New pages are added with the `add` method. The extra argument `label` is used to specify the tab label. This may be a string, or a `glabel`. The extra argument `index` can be used to specify which page to add to. By default, a new page is created at the end of the notebook. The extra argument `override.closebutton` can be used to add or not add a close button in the tab label.

The `dispose` method will remove the currently selected page unless it is overridden by the value of `dontCloseThese`.

The `delete(obj, widget,...)` method will delete the widget on a given page. This can then be replaced with the `[<-` method.

The `length` method returns the number of pages.

The `names` method returns the tab labels.

The `names<-` method may be used to replace the tab labels. Something like `names(obj)[1]<-"new label"` should work.

The `"["` method refers to the widgets in the notebook.

The `"[<-"` method can be used to replace a widget on a notebook page.

### Examples

    ## Not run:
      nb = gnotebook(container=TRUE)
      add(nb, glabel("Widget 1"), label="page 1")
      add(nb, glabel("Widget 2"), label=glabel("page 2"))

      length(nb)
      names(nb)
      names(nb)[1] <- "Page 1"

      svalue(nb) <- 3
      dispose(nb)
      length(nb)
    ## End(Not run)

[Package gWidgets version 0.0-25 Index]