gpanedgroup: constructor for a two-paned container

In gWidgets2: Rewrite of gWidgets API for Simplified GUI Construction

Description

A container for holding two child widgets where the space allocated to each can be manipulated by the user with a pane between the widgets, or programatticaly via svalue<-. The value specified to svalue<- can be a number in $[0,1]$, in which case it is a proportion or an integer, in which case it is a pixel size (from the left or the top). The ambiguous case 1 or 1L is determined by class. The value of svalue is in proportion units.

Usage

gpanedgroup(horizontal = TRUE, container = NULL, ..., toolkit = guiToolkit())

.gpanedgroup(toolkit, horizontal = TRUE, container = NULL, ...)

Arguments

horizontal	direction of layout
container	A parent container. When a widget is created it can be incorporated into the widget heirarchy by passing in a parent container at construction time. (For some toolkits this is not optional, e.g. gWidgets2tcltk or gWidgets2WWW2.)
...	These values are passed to the add method of the parent container. Examples of values are expand, fill, and anchor, although they're not always supported by a given widget. For more details see add. Occasionally the variable arguments feature has been used to sneak in hidden arguments to toolkit implementations. For example, when using a widget as a menubar object one can specify a parent argument to pass in parent information, similar to how the argument is used with gaction and the dialogs.
toolkit	Each widget constructor is passed in the toolkit it will use. This is typically done using the default, which will lookup the toolkit through guiToolkit.

Details

Child widgets are added in the usual way, typically through the container argument of a constructor. Only two children may be added. Children expand and fill the allocated space.

Note

Setting the size is often only possible after the container has been realized on the screen. In the example, this call of svalue<- is done after the parent window is made visible for this reason. There were arguments to specify the children at construction, but these have been removed.

Examples

## Not run: 
w <- gwindow("gpanedgroup", visible=FALSE)
pg <- gpanedgroup(cont=w)
gbutton("left", cont=pg)
gbutton("right", cont=pg)

visible(w) <- TRUE
svalue(pg) <- 0.33

## End(Not run)

gWidgets2 documentation built on Jan. 11, 2022, 1:07 a.m.