Package 'JGR'

New JGR Console Menu

Description

adds a new Menu to MenuBar in JGR Console

Usage

jgr.addMenu(name)
jgr.insertMenu(name, index)

Arguments

name	Menu name
index	index at which to insert

Value

Menu

See Also

jgr.addMenuItem jgr.addMenuSeparator

Examples

jgr.addMenu("Workspace")
jgr.addMenuItem("Workspace","Browse","ls()")
jgr.addMenuSeparator("Workspace")
jgr.addMenuItem("Workspace","Browse (pos=2)","ls(pos=2)")


menus <- jgr.getMenuNames()
index <- which(menus=="Packages & Data")
if(length(index)==0) index <- 1

jgr.insertMenu("User menu", index)
jgr.addMenuItem("User menu", "Good place for user generated menus is",
                "print('before Packages & Data')")

---

New JGR Console MenuItem

Description

adds a new MenuItem to specified JGR Console Menu

Usage

jgr.addMenuItem(menu,name,command,silent=TRUE)
jgr.insertMenuItem(menu,name,command,index,silent=TRUE)

Arguments

menu	Name of the menu that this item will be added to
name	Name of the menu item to add
command	R expression(s) as a string to be parsed and evaluated or a function that will be called (without arguments) when the menu item is selected
index	index at which to insert
silent	If FALSE, executes as if entered into the cons

Value

MenuItem

See Also

jgr.addMenu jgr.addMenuSeparator

Examples

jgr.addMenu("Workspace")
jgr.addMenuItem("Workspace","Browse","ls()",FALSE)
jgr.addMenuSeparator("Workspace")
jgr.addMenuItem("Workspace","List Functions",
  function() unlist(lapply(ls(envir=.GlobalEnv),
                           function(x) if (is.function(get(x))) x else NULL )))

---

New JGR Console MenuSeparator

Description

adds a Separator to a Menu in JGR Console

Usage

jgr.addMenuSeparator(menu)
jgr.insertMenuSeparator(menu,index)

Arguments

menu	name of the menu to add this separator to
index	index at which to insert

Value

Menu

See Also

jgr.addMenu jgr.addMenuItem

Examples

jgr.addMenu("Workspace")
jgr.addMenuItem("Workspace","Browse","ls()")
jgr.addMenuSeparator("Workspace")
jgr.addMenuItem("Workspace","Browse (pos=2)","ls(pos=2)")

---

New JGR Console sub-menu

Description

adds a sub-menu to a Menu in JGR Console

Usage

jgr.addSubMenu(menu, subMenuName, labels, commands)
jgr.insertSubMenu(menu, subMenuName, labels, commands,index)

Arguments

menu	name of the menu to add this sub-menu to
subMenuName	name of the sub-menu
labels	a character vector of menu items
commands	a character vector of commands to be exectued
index	index at which to insert

Value

Menu

See Also

jgr.addMenu jgr.addMenuItem

Examples

jgr.addMenu("added menu")
jgr.addMenuItem("added menu", "print 1","print(1)")
jgr.insertMenuItem("added menu","print 1 as if entered in console","print(1)",1,FALSE)
jgr.addMenuSeparator("added menu")
jgr.addSubMenu("added menu","sub menu",c("a","b","c"),c("print('a')","print('b')","print('c')"))

---

JGR Console menus

Description

returns the menu / menu item names

Usage

jgr.getMenuNames()
jgr.getMenuItemNames(menu)

Arguments

menu	name of the menu

Value

a character vector

See Also

jgr.addMenu jgr.addMenuItem

Examples

menus <- jgr.getMenuNames()
index <- which(menus=="Packages & Data")
if(length(index)==0) index <- 1

jgr.insertMenu("User menu",index)
jgr.addMenuItem("User menu", "Good place for user generated menus is",
                "print('before Packages & Data')")

---

Internal JGR functions

Description

The following functions are publicly visible, but with the expection of JGR they should be only invoked from the GUI and not directly by the user.

---

remove JGR Console menus

Description

removes a menu / menu item

Usage

jgr.removeMenu(index)
jgr.removeMenuItem(menu,index)

Arguments

menu	name of the menu
index	index of the item to remove

See Also

jgr.addMenu jgr.addMenuItem

Examples

jgr.addMenu("added menu")
jgr.addMenuItem("added menu", "print 1","print(1)")
jgr.insertMenuItem("added menu","print 1 as if entered in console","print(1)",1,FALSE)
jgr.addMenuSeparator("added menu")
jgr.addSubMenu("added menu","sub menu",c("a","b","c"),c("print('a')","print('b')","print('c')"))

jgr.removeMenuItem("added menu",1)
jgr.removeMenu(length(jgr.getMenuNames()))

---

Supplemental JGR functions

Description

The following functions are publicly visible, but with the expection of JGR they are usually invoked from the GUI and rarely directly by the user.

JGR can be used to update JGR including dependent packages or to start JGR from within R. JGR is always started as an independent application and the preferred way to start JGR is using launchers that are provided from the JGR website http://www.rosuda.org

Usage

JGR(update = FALSE, javaArgs = NULL, jgrArgs = "")
broken.gomp()
installPackages(contriburl = NULL, type = getOption("pkgType"))
jgr.pager(file, header, title, delete.file)
jgr.browser(url, ...)
jgr.set.options(..., useJavaGD = TRUE, useJGRpager = TRUE,
                useJGRbrowser = TRUE, useHTMLHelp = TRUE)
object.browser()
package.manager()
reformat.code(txt)

Arguments

update	If set to TRUE then JGR is updated for the RoSuDa repository (internet connection is required).
javaArgs	Arguments for Java.
jgrArgs	Arguments passed to the main method of JGR.
contriburl	same as in install.packages
type	JGR uses the package type set in the R options
file	file to show
header	header for each file
title	overall title for the display
delete.file	should the files be deleted after display? Used for temporary files.
url	url to show
useJavaGD	if set to TRUE, JavaGD is set as the default device
useJGRpager	if set to TRUE, jgr.pager function is used as the default pager
useJGRbrowser	if set to TRUE, jgr.browser function is used as the default browser
useHTMLHelp	if set to TRUE, HTML help used as the default
...	additional parameters or options to set
txt	R code to be made pretty

---

Creates a new process launching the JGR Console

Description

Creates a new process launching the JGR Console

Usage

launchJGR(javaArgs=NULL,jgrArgs="",popMsgs=TRUE)

Arguments

javaArgs	Arguments for Java.
jgrArgs	Arguments passed to the main method of JGR.
popMsgs	If true, system pop-up messages are displayed if any errors are encountered.

Value

The system call for launching JGR

---