Get the Windows handle of a window or of the R process.
Usage
getWindowsHandle(which = "Console")
Arguments
which
A string (see below), or the number of a
graphics device window
Details
getWindowsHandle gets the Windows handle.
Possible choices for which are:
"Console"
The console window handle.
"Frame"
The MDI frame window handle.
"Process"
The process pseudo-handle.
A device number
The window handle of a graphics device
These values are not normally useful to users, but may be used by
developers making add-ons to R.
NULL is returned for the Frame handle if not running in MDI mode,
for the Console handle when running Rterm, for any unrecognized
string for which, or for a graphics device with no
corresponding window.
Other windows (help browsers, etc.) are not accessible
through this function.
Value
An external pointer holding the Windows handle, or NULL.
Note
This is only available on Windows.
See Also
getIdentification, getWindowsHandles
Examples
getWindowsHandle()
Results
R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)
R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.
R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.
Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.
> library(utils)
> png(filename="/home/ddbj/snapshot/RGM3/R_rel/result/utils/getWindowsHandle.Rd_%03d_medium.png", width=480, height=480)
> ### Name: getWindowsHandle
> ### Title: Get a Windows Handle
> ### Aliases: getWindowsHandle
> ### Keywords: utilities
>
> ### ** Examples
>
> getWindowsHandle()
Error: could not find function "getWindowsHandle"
Execution halted