arrangeWindows
Rearrange Windows on MS Windows
This function allows you to tile or cascade windows, or to minimize or
restore them (on Windows, i.e. when (.Platform$OS.type == "windows")
).
This may include windows not “belonging” to R.
- Keywords
- utilities
Usage
arrangeWindows(action, windows, preserve = TRUE, outer = FALSE)
Arguments
- action
a character string, the action to perform on the windows. The choices are
c("vertical", "horizontal", "cascade", "minimize", "restore")
with default"vertical"
; see the ‘Details’ for the interpretation. Abbreviations may be used.- windows
a
list
of window handles, by default produced bygetWindowsHandles()
.- preserve
If
TRUE
, when tiling preserve the outer boundary of the collection of windows; otherwise make them as large as will fit.- outer
This argument is only used in MDI mode. If
TRUE
, tile the windows on the system desktop. Otherwise, tile them within the MDI frame.
Details
The actions are as follows:
"vertical"
Tile vertically.
"horizontal"
Tile horizontally.
"cascade"
Cascade the windows.
"minimize"
Minimize all of the windows.
"restore"
Restore all of the windows to normal size (not minimized, not maximized).
The tiling and cascading are done by the standard Windows API functions, but unlike those functions,
they will apply to all of the windows in the windows
list.
By default, windows
is set to the result of
getWindowsHandles()
(with one exception described
below). This will select windows belonging to the current R process.
However, if the global environment contains a variable named
.arrangeWindowsDefaults
, it will be used as the argument list
instead. See the getWindowsHandles
man page for a
discussion of the optional arguments to that function.
When action = "restore"
is used with windows
unspecified,
minimized = TRUE
is added to the argument list of
getWindowsHandles
so that minimized windows will be restored.
In MDI mode, by default tiling and cascading will happen within the R
GUI frame. However, if outer = TRUE
, tiling is done on the system
desktop. This will generally not give desirable results if any R child
windows are included within windows
.
Value
This function is called for the side effect of arranging the windows. The list of window handles is returned invisibly.
Note
This is only available on Windows.
See Also
Examples
library(utils)
# NOT RUN {
## Only available on Windows :
arrangeWindows("v")
# This default is useful only in SDI mode: it will tile any Firefox window
# along with the R windows
.arrangeWindowsDefaults <- list(c("R", "all"), pattern = c("", "Firefox"))
arrangeWindows("v")
# }