gwindow {gWidgets2} | R Documentation

## gwindow

### Description

top-level window object

S3 generic whose methods are implemented in the toolkit packages

Dispatches on type of child (menubar, toolbar, statusbar, widget)

The `dispose` method destroys the top-level window and its children.

### Usage

    gwindow(title = "Window", visible = TRUE, name = title, width = NULL,
      height = NULL, parent = NULL, handler = NULL, action = NULL, ...,
      toolkit = guiToolkit())

    .gwindow(toolkit, title, visible, name, width, height, parent, handler, action,
      ...)

    ## S3 method for class 'GWindow'
    add(obj, child, expand = NULL, fill = NULL,
      anchor = NULL, ...)

    ## S3 method for class 'GWindow'
    dispose(obj, ...)

### Arguments

`title` | title for window's title bar. This is the main property and is accessed via `svalue` or `svalue<-`.
`visible` | logical. If codeTRUE window is drawn when constructed. Otherwise, window can be drawn later using `visible<-`. This value can default to `FALSE` by setting the option: `options("gWidgets:gwindow-default-visible-is-false"=TRUE)`. There are advantages: windows can draw slowly when adding many items. With gWidgets2RGtk2, the `ggraphics` widget can like to be added to an undrawn widget as this avoids sizing issue.
`name` | Name for registry of windows
`width` | initial width of window
`height` | initial height of window. This sets height before window manager manages the window
`parent` | If non-NULL, can be used to suggest default location of window. The argument name was changed from location to parent. This can be a coordinate pair (x,y) with (0,0) the upper left corner, or a gwindow instance. In the latter case the location is suggested by the location of the current window. This is useful for placing dialogs near the parent window.
`handler` | handler for destroy event
`action` | action passed t handler
`...` | ignored
`toolkit` | toolkit
`obj` | parent object
`child` | child widget
`expand` | NULL or logical. For box containers controls whether a child will expand to fill the allocated space.
`fill` | NULL or character. For box containers. The value of `fill` (not always respected) is used to control if expansion happens vertically (`y`), horizontally (`x`) or both (`both` or `TRUE`). For vertically filled box containers, children always fill horizontally (atleast) and for horizontally filled box containers, children always fill vertically (atleast). This is important to realize when trying to size buttons, say.
`anchor` | NULL or integer. For box containers. The anchor argument is used to position the child within the parent when there is more space allocated than the child requests. This is specified with a Cartesian pair in -1,0,1 x -1, 0, 1.

### Value

a `GWindow` instance

### Author(s)

john verzani

[Package gWidgets2 version 1.0-8 Index]