grid.place.html
2.71 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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>R: Place an Object within a Frame</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.place {grid}"><tr><td>grid.place {grid}</td><td align="right">R Documentation</td></tr></table>
<h2>Place an Object within a Frame</h2>
<h3>Description</h3>
<p>
These functions provide a simpler (and faster) alternative
to the <code>grid.pack()</code> and <code>packGrob</code>
functions. They can be used to place objects within the existing
rows and columns of a frame layout. They do not provide the ability to
add new rows and columns nor do they affect the
heights and widths of the rows and columns.
</p>
<h3>Usage</h3>
<pre>
grid.place(gPath, grob, row = 1, col = 1, redraw = TRUE)
placeGrob(frame, grob, row = NULL, col = NULL)
</pre>
<h3>Arguments</h3>
<table summary="R argblock">
<tr valign="top"><td><code>gPath</code></td>
<td>
A gPath object, which specifies a frame on the
display list.</td></tr>
<tr valign="top"><td><code>frame</code></td>
<td>
An object of class <code>frame</code>, typically the output
from a call to <code>grid.frame</code>. </td></tr>
<tr valign="top"><td><code>grob</code></td>
<td>
An object of class <code>grob</code>. The object to be
placed. </td></tr>
<tr valign="top"><td><code>row</code></td>
<td>
Which row to add the object to. Must be between 1 and
the-number-of-rows-currently-in-the-frame. </td></tr>
<tr valign="top"><td><code>col</code></td>
<td>
Which col to add the object to. Must be between 1 and
the-number-of-cols-currently-in-the-frame. </td></tr>
<tr valign="top"><td><code>redraw</code></td>
<td>
A boolean indicating whether the output should be updated. </td></tr>
</table>
<h3>Details</h3>
<p>
<code>placeGrob</code> modifies the given frame grob and returns the modified
frame grob.
</p>
<p>
<code>grid.place</code> destructively modifies a frame grob on the display
list (and redraws the display list if <code>redraw</code> is <code>TRUE</code>).
</p>
<h3>Value</h3>
<p>
<code>placeGrob</code> returns a frame grob, but <code>grid.place</code> returns
<code>NULL</code>.</p>
<h3>Author(s)</h3>
<p>
Paul Murrell
</p>
<h3>See Also</h3>
<p>
<code><a href="grid.frame.html">grid.frame</a></code>,
<code><a href="grid.pack.html">grid.pack</a></code>,
<code><a href="grid.edit.html">grid.edit</a></code>, and <code><a href="gPath.html">gPath</a></code>.
</p>
<hr><div align="center">[Package <em>grid</em> version 2.5.1 <a href="00Index.html">Index]</a></div>
</body></html>