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 parent container to attach notebook widget to
... passed to add method of parent container
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:

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 in gWidgetsRGtk2 a glabel instance. 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. In gWidgetsRGtk2, 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 svalue method returns the current page number. The svalue<- method is used to set the page number.

The delete(obj, widget,...) method will delete the widget on a given page. This can then be replaced with the add 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.

See Also

See gwindow for top-level containers, ggroup, gframe and gexpandgroup for box containers

Examples

## Not run: 
  w <- gwindow("gnotebook example")
  nb <- gnotebook(container=w)
  glabel("Widget 1", cont=nb, label="page 1")
  glabel("Widget 2", cont=nb, label="page 2")

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

  svalue(nb) <- 2
  dispose(nb) ## dispose current tab
  length(nb) 
## End(Not run)

[Package gWidgets version 0.0-35 Index]