1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
\name{gwindow}
\alias{gwindow}
%- Also NEED an '\alias' for EACH other topic documented here.
\title{Constructor for base container}
\description{
Widgets are packed inside containers which may in turn be packed
inside other containers. The base container is known as a window. Only
one container may be packed inside a window.
}
\usage{
gwindow(title = "Window", visible = TRUE, name=title,
width = NULL, height= NULL, parent=NULL,
handler = NULL, action = NULL,
..., toolkit = guiToolkit())
}
%- maybe also 'usage' for other objects documented here.
\arguments{
\item{title}{Title of window}
\item{visible}{If \code{TRUE} window is drawn when
constructed. Otherwise, window can be drawn latter using \code{visible<-}. This value can default to \code{FALSE} by
setting the option: \code{options("gWidgets:gwindow-default-visible-is-false"=TRUE)}. There are advantages: windows can draw slowly when adding item by item; \code{ggraphics} like to be added to an undrawn widget as this avoids a sizing issue.}
\item{name}{Name for registry of windows}
\item{width}{Default width for window at creation}
\item{height}{Default height for window at creation}
\item{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.}
\item{handler}{Handler for destroy event.}
\item{action}{Passed to handler}
\item{\dots}{Not used}
\item{toolkit}{Which GUI toolkit to use}
}
\details{
A base window can also be created using the argument
\code{container=TRUE} when constructing a widget.
The \code{svalue} method returns the window title. Use
\code{svalue<-} to change the title.
The \code{add} method is used to add a widget or container to the
base window. For top-level windows, some toolkits only support adding
one widget, so in gWidgets only one widget should be added to a
window, so usually it would be another container.
Additionally the menubar, toolbar and statusbar widgets should now
be added and deleted from the top-level window. Outside of RGtk2,
the other toolkits expect these items to be properties of a
top-level window.
The \code{dispose} method destroys the window.
The \code{size} method sets the minimum size. Use the \code{width}
and \code{height} arguments to set the default size when the window
is constructed.
A window is destroyed in response to a destroy event. However, when
the window managager tries to close a window first a "delete-event"
is issued. If this has the right value then the "destroy" event is
fired. The \code{addHandlerUnrealize} handler can be called to
intercept the closing of the window. Its handler should return a
logical: \code{TRUE} to prevent the closing, \code{FALSE} to proceed. This may not work on all toolkits
}
% \value{}
% \references{}
% \author{}
% \note{}
% \seealso{}
\examples{
\dontrun{
## window with handler
win <- gwindow("Window example",
handler=function(h,...) {
print("See ya")
})
gbutton("cancel", container=win,
handler = function(h,...) dispose(win))
## block closing of window
win <- gwindow("Window example")
addHandlerUnrealize(win, handler = function(h,...) {
val <- gconfirm("Really close window", parent=h$obj)
if(as.logical(val))
return(FALSE) # destroy
else
return(TRUE) # don't destroy
})
## transient dialog (gWidgetsRGtk2)
pwin <- gwindow("Parent window")
cwin <- gwindow("Child window", parent = pwin)
## clicking button close parent causing child to close too
gbutton("close both", container=cwin,
handler = function(h,...) dispose(pwin))
}
}
\keyword{interface}% at least one, from doc/KEYWORDS
|
