The R Project SVN R

Rev

Rev 59039 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 59039 Rev 61433
Line 11... Line 11...
11 
}
 11 
}
12 
\usage{
 12 
\usage{
13 
getWindowsHandle(which = "Console")
 13 
getWindowsHandle(which = "Console")
14 
}
 14 
}
15 
\arguments{
 15 
\arguments{
16 
  \item{which}{A string (see below), or the number of a
16 
  \item{which}{A string (see below), or the number of a
17 
                graphics device window}
 17 
                graphics device window}
18 
}
 18 
}
19 
\details{
 19 
\details{
20 
  \code{getWindowsHandle} gets the Windows handle.
 20 
  \code{getWindowsHandle} gets the Windows handle.
21 
  Possible choices for \code{which} are:
 21 
  Possible choices for \code{which} are:
22 
  \tabular{ll}{
 22 
  \tabular{ll}{
23 
  \code{"Console"} \tab The console window handle. \cr
 23 
  \code{"Console"} \tab The console window handle. \cr
24 
  \code{"Frame"}   \tab The MDI frame window handle. \cr
 24 
  \code{"Frame"}   \tab The MDI frame window handle. \cr
25 
  \code{"Process"} \tab The process pseudo-handle. \cr
 25 
  \code{"Process"} \tab The process pseudo-handle. \cr
26 
  A device number \tab The window handle of a graphics device
26 
  A device number \tab The window handle of a graphics device
27 
 }
 27 
 }
28 
  These values are not normally useful to users, but may be used by
28 
  These values are not normally useful to users, but may be used by
29 
  developers making add-ons to \R{}.
 29 
  developers making add-ons to \R{}.
30
30 
 
31 
  \code{NULL} is returned for the Frame handle if not running in MDI mode,
31 
  \code{NULL} is returned for the Frame handle if not running in MDI mode,
32 
  for the Console handle when running Rterm, for any unrecognized
32 
  for the Console handle when running Rterm, for any unrecognized
33 
  string for \code{which}, or for a graphics device with no
33 
  string for \code{which}, or for a graphics device with no
34 
  corresponding window.
 34 
  corresponding window.
35
35 
 
36 
  Other windows (help browsers, etc.) are not accessible
36 
  Other windows (help browsers, etc.) are not accessible
37 
  through this function.
 37 
  through this function.
38 
}
 38 
}
39 
\note{
39 
\note{
40 
  As from R 2.6.0, this function returns an external pointer rather than
 40 
  As from R 2.6.0, this function returns an external pointer rather than
41 
  an integer value, and \code{which = "ProcessId"} is no longer supported.
 41 
  an integer value, and \code{which = "ProcessId"} is no longer supported.
42 
  Use \code{\link{Sys.getpid}} for the latter.
 42 
  Use \code{\link{Sys.getpid}} for the latter.
43 
}
 43 
}
44 
\value{
 44 
\value{