Get handles of Windows in the MS Windows RGui

Description

This function gets the Windows handles of visible top level windows orwindows within theR MDI frame (when using theRgui).

Usage

getWindowsHandles(which = "R", pattern = "", minimized = FALSE)

Arguments

Details

This function will search for Windows handles, for passing to externalGUIs or to thearrangeWindows function. Each of thearguments may be a vector of values. These will be treated asfollows:

• The arguments will all be recycled to the same length.

• The corresponding elements of each argument will be applied inseparate searches.

• The final result will be the union of the windows identified ineach of the searches.

If an element ofwhich is"R", only windows belonging tothe currentR process will be returned. In MDI mode, those will be thechild windows within theR GUI (Rgui) frame. In SDI mode,all windows belonging to the process will be included.

If the element is"all", then top level windows will be returned.

The elements ofpattern will be used to make a subset of windowswhose title text matches (according togrep) the pattern.

Ifminimized = FALSE, minimized windows will be ignored.

Value

A list of external pointers containing the window handles.

Note

This is only available on Windows.

Author(s)

Duncan Murdoch

See Also

arrangeWindows,getWindowsHandle (singular).

Examples

if(.Platform$OS.type == "windows") withAutoprint({  getWindowsHandles()  getWindowsHandles("all")})