grid.frame.html
2.69 KB
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>R: Create a Frame for Packing Objects</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css" href="../../R.css">
</head><body>
<table width="100%" summary="page for grid.frame {grid}"><tr><td>grid.frame {grid}</td><td align="right">R Documentation</td></tr></table>
<h2>Create a Frame for Packing Objects</h2>
<h3>Description</h3>
<p>
These functions, together with <code>grid.pack</code>,
<code>grid.place</code>, <code>packGrob</code>, and <code>placeGrob</code> are part of a
GUI-builder-like interface to constructing graphical images.
The idea is that you create a frame with this function then
use <code>grid.pack</code> or whatever to pack/place objects into the frame.
</p>
<h3>Usage</h3>
<pre>
grid.frame(layout=NULL, name=NULL, gp=gpar(), vp=NULL, draw=TRUE)
frameGrob(layout=NULL, name=NULL, gp=gpar(), vp=NULL)
</pre>
<h3>Arguments</h3>
<table summary="R argblock">
<tr valign="top"><td><code>layout</code></td>
<td>
A Grid layout, or NULL. This can be used to initialise
the frame with a number of rows and columns, with initial widths
and heights, etc. </td></tr>
<tr valign="top"><td><code>name</code></td>
<td>
A character identifier. </td></tr>
<tr valign="top"><td><code>vp</code></td>
<td>
An object of class <code>viewport</code>, or NULL. </td></tr>
<tr valign="top"><td><code>gp</code></td>
<td>
An object of class <code>gpar</code>; typically the output from
a call to the function <code>gpar</code>.</td></tr>
<tr valign="top"><td><code>draw</code></td>
<td>
Should the frame be drawn. </td></tr>
</table>
<h3>Details</h3>
<p>
Both functions create a frame grob (a graphical object describing a
frame), but only <code>grid.frame()</code>
draws the frame (and then only if <code>draw</code> is <code>TRUE</code>).
Nothing will actually be
drawn, but it will put the frame on the display list, which means
that the output will be dynamically updated as objects are packed
into the frame. Possibly useful for debugging.
</p>
<h3>Value</h3>
<p>
A frame grob. <code>grid.frame()</code> returns the value invisibly.</p>
<h3>Author(s)</h3>
<p>
Paul Murrell
</p>
<h3>See Also</h3>
<p>
<code><a href="grid.pack.html">grid.pack</a></code>
</p>
<h3>Examples</h3>
<pre>
grid.newpage()
grid.frame(name="gf", draw=TRUE)
grid.pack("gf", rectGrob(gp=gpar(fill="grey")), width=unit(1, "null"))
grid.pack("gf", textGrob("hi there"), side="right")
</pre>
<hr><div align="center">[Package <em>grid</em> version 2.5.1 <a href="00Index.html">Index]</a></div>
</body></html>