| Line 48... |
Line 48... |
| 48 |
part of the value of the call.
|
48 |
part of the value of the call.
|
| 49 |
}
|
49 |
}
|
| 50 |
\details{
|
50 |
\details{
|
| 51 |
\code{identify} is a generic function, and only the default method is
|
51 |
\code{identify} is a generic function, and only the default method is
|
| 52 |
described here.
|
52 |
described here.
|
| 53 |
|
53 |
|
| 54 |
\code{identify} is only supported on screen devices such as
|
54 |
\code{identify} is only supported on screen devices such as
|
| 55 |
\code{X11}, \code{windows} and \code{quartz}. On other devices the
|
55 |
\code{X11}, \code{windows} and \code{quartz}. On other devices the
|
| 56 |
call will do nothing.
|
56 |
call will do nothing.
|
| 57 |
|
57 |
|
| 58 |
Clicking near (as defined by \code{tolerance}) a point adds it to the
|
58 |
Clicking near (as defined by \code{tolerance}) a point adds it to the
|
| 59 |
list of identified points. Points can be identified only once, and if
|
59 |
list of identified points. Points can be identified only once, and if
|
| 60 |
the point has already been identified or the click is not
|
60 |
the point has already been identified or the click is not
|
| 61 |
near any of the points a message is printed immediately on
|
61 |
near any of the points a message is printed immediately on
|
| 62 |
the \R console.
|
62 |
the \R console.
|
| 63 |
|
63 |
|
| 64 |
If \code{plot} is \code{TRUE}, the point is labelled with the
|
64 |
If \code{plot} is \code{TRUE}, the point is labelled with the
|
| 65 |
corresponding element of \code{labels}. If \code{atpen} is false (the
|
65 |
corresponding element of \code{labels}. If \code{atpen} is false (the
|
| 66 |
default) the labels are placed below, to the left, above or to the
|
66 |
default) the labels are placed below, to the left, above or to the
|
| 67 |
right of the identified point, depending on where the pointer was
|
67 |
right of the identified point, depending on where the pointer was
|
| 68 |
relative to the point. If \code{atpen} is true, the
|
68 |
relative to the point. If \code{atpen} is true, the
|
| Line 79... |
Line 79... |
| 79 |
#ifdef windows
|
79 |
#ifdef windows
|
| 80 |
The identification process is terminated by clicking the second button
|
80 |
The identification process is terminated by clicking the second button
|
| 81 |
and selecting \sQuote{Stop} from the menu, or from the \sQuote{Stop}
|
81 |
and selecting \sQuote{Stop} from the menu, or from the \sQuote{Stop}
|
| 82 |
menu on the graphics window.
|
82 |
menu on the graphics window.
|
| 83 |
#endif
|
83 |
#endif
|
| 84 |
|
84 |
|
| 85 |
On most devices which support \code{identify}, successful selection of
|
85 |
On most devices which support \code{identify}, successful selection of
|
| 86 |
a point is indicated by a bell sound unless
|
86 |
a point is indicated by a bell sound unless
|
| 87 |
\code{\link{options}(locatorBell = FALSE)} has been set.
|
87 |
\code{\link{options}(locatorBell = FALSE)} has been set.
|
| 88 |
|
88 |
|
| 89 |
If the window is resized or hidden and then exposed before the identification
|
89 |
If the window is resized or hidden and then exposed before the identification
|
| 90 |
process has terminated, any labels drawn by \code{identify}
|
90 |
process has terminated, any labels drawn by \code{identify}
|
| 91 |
will disappear. These will reappear once the identification process has
|
91 |
will disappear. These will reappear once the identification process has
|
| 92 |
terminated and the window is resized or hidden and exposed again.
|
92 |
terminated and the window is resized or hidden and exposed again.
|
| 93 |
This is because the labels drawn by \code{identify} are not
|
93 |
This is because the labels drawn by \code{identify} are not
|
| 94 |
recorded in the device's display list until the identification process has
|
94 |
recorded in the device's display list until the identification process has
|
| 95 |
terminated.
|
95 |
terminated.
|
| 96 |
|
96 |
|
The R Project SVN
R